La ruta crítica de renderizado: por qué el navegador todavía no puede pintar

  • vuetelemetry
  • Guías
  • 9 min de lectura

Cada métrica de tu informe de Lighthouse está en algún punto de una misma cadena: de los bytes al DOM, del DOM y el CSSOM al árbol de renderizado, del árbol a la maquetación, de la maquetación al pintado. Optimizar una etapa tardía no sirve mientras una temprana esté bloqueada, y una etapa bloquea de una forma que casi nadie espera.

La ruta crítica de renderizado es la secuencia que ejecuta el navegador entre recibir el primer byte de HTML y poner el primer píxel en pantalla. Merece conocerse no como curiosidad, sino porque es una cadena: cada etapa consume el resultado de la anterior. Esa sola propiedad explica por qué la mayor parte del trabajo de rendimiento falla: puedes recortar una etapa que nunca fue la que esperaba.

Etapa 0: llegan los bytes. Nada en la ruta puede empezar antes del primer byte, y por eso el time to first byte pone un suelo bajo todo lo que viene después. Ningún trabajo de front-end levanta ese suelo; es una decisión de servidor y de red.

Etapa 1: el HTML se convierte en el DOM. El analizador lee el marcado y construye un árbol de nodos. Es incremental: el navegador no espera al documento completo, construye a medida que llegan los bytes, y por eso merece la pena enviar el HTML en flujo.

Etapa 2: el CSS se convierte en el CSSOM. Las hojas de estilo se analizan en un árbol paralelo de estilos calculados. A diferencia del DOM, este no sirve hasta que está completo. Una regla posterior puede anular otra anterior, así que un CSSOM parcial podría producir estilos simplemente erróneos. Por eso el navegador espera a todas las hojas de estilo que considera aplicables antes de pintar nada. Es lo que se quiere decir con que el CSS *bloquea el renderizado*.

Etapa 3: el árbol de renderizado. El DOM y el CSSOM se combinan en un árbol con solo lo que se va a mostrar. Los nodos con `display: none` no aparecen en él, ni nada de lo que está en `<head>`. Ojo: `visibility: hidden` es distinto: el elemento está en el árbol y ocupa su espacio, solo que no se pinta.

Etapa 4: la maquetación. El navegador calcula la geometría de cada nodo del árbol: posición y tamaño, en unidades reales, respecto a la ventana. Aquí un porcentaje se convierte en un número de píxeles, y por eso una imagen sin dimensiones te cuesta después: la geometría hay que rehacerla cuando llega el tamaño real, que es el mecanismo del cumulative layout shift.

Etapa 5: pintado y composición. Se producen los píxeles, a veces en varias capas, y luego se componen en el fotograma que ves. La primera vez que esto termina es tu first contentful paint; el fotograma en el que aparece el elemento más grande es tu largest contentful paint.

La etapa que bloquea de una forma que nadie espera. Un `<script>` clásico detiene el analizador; eso es bien conocido y se trata en los recursos que bloquean el renderizado. Lo que sorprende es la interacción entre los dos mecanismos de bloqueo: un script síncrono puede leer estilos calculados, así que el navegador no puede ejecutarlo hasta que el CSSOM esté listo. Una hoja de estilo todavía en descarga retrasa por tanto un script que ya terminó de descargarse, y ese script a su vez retiene al analizador. Un solo archivo CSS lento puede frenar la construcción de un DOM con el que no tiene ninguna relación aparente.

Por qué el navegador no está tan atascado como parece. Mientras el analizador está bloqueado, un *preload scanner* secundario sigue leyendo por delante el marcado en bruto en busca de recursos que empezar a descargar. Por eso un analizador bloqueado no significa una red inactiva. También tiene un punto ciego que conviene conocer: solo ve los recursos escritos en el HTML. Lo que un script inyecta después le resulta invisible, y solo empieza a descargarse cuando ese script se ha ejecutado.

Lo que significa en la práctica. Pregúntate qué etapa está esperando de verdad antes de optimizar. Comprimir imágenes no hace nada en una página cuyo pintado retiene una hoja de estilo. Incrustar el CSS crítico no hace nada en una página cuyo primer byte tarda 800 ms. La cadena tiene un solo eslabón más lento a la vez, y el perfilador te dice cuál: la cascada de tu herramienta de laboratorio es una imagen de esta ruta, etapa por etapa.

Y una salvedad para las aplicaciones de una sola página. Todo lo anterior describe el primer pintado. En una página renderizada por un framework, el resultado visible puede llegar mucho antes de que la página sea utilizable, porque el marcado todavía tiene que conectarse con el código: consulta la hidratación para ver por qué un pintado rápido y una página que responde no son lo mismo.

La lección práctica es un hábito más que una lista: antes de cambiar nada, nombra la etapa que crees que es el cuello de botella y di cómo la verías moverse. Si no puedes, estás optimizando un eslabón que no era el lento. La guía de los Core Web Vitals vincula cada métrica con la etapa que mide.

Una vez desbloqueada la cadena, el siguiente coste son los propios scripts: reducir el tiempo de ejecución de JavaScript explica qué quitar antes de intentar acelerar nada.

FAQ

¿Qué es la ruta crítica de renderizado?

Es la secuencia de pasos que sigue un navegador para convertir HTML, CSS y JavaScript en píxeles en pantalla: construir el DOM a partir del HTML, el CSSOM a partir del CSS, combinarlos en un árbol de renderizado, calcular la geometría de la maquetación y luego pintar y componer. Se llama crítica porque todo lo que ve el usuario depende de ella, y porque los pasos están estrictamente ordenados: cada uno consume el resultado del anterior.

¿Por qué el CSS bloquea el renderizado y el HTML no?

El DOM puede construirse de forma incremental: un árbol parcial sigue siendo correcto en lo que contiene, así que el navegador avanza a medida que llegan los bytes. El CSSOM no, porque una regla que llega después puede anular otra anterior. Pintar a partir de un CSSOM parcial mostraría estilos que la hoja completa contradice, así que el navegador espera a que terminen las hojas aplicables antes de pintar nada.

¿De verdad una hoja de estilo retrasa un archivo JavaScript ya descargado?

Sí, si el script es síncrono. Un script así puede leer estilos calculados, así que el navegador no puede ejecutarlo con seguridad hasta que el CSSOM esté listo. El script espera a la hoja de estilo, y el analizador espera al script. Es el acoplamiento menos intuitivo de la ruta, y significa que un archivo CSS lento puede retrasar una construcción del DOM que parece no tener relación con él.

¿Qué es el preload scanner?

Un analizador secundario que lee por adelantado el HTML en bruto mientras el analizador principal está bloqueado y empieza a descargar los recursos que encuentra. Es la razón de que un analizador bloqueado no deje la red inactiva. Su limitación es que solo ve lo que está escrito en el marcado: los recursos que añade JavaScript después le son invisibles y no pueden empezar a descargarse hasta que se ejecuta ese script.

¿Qué diferencia hay entre el árbol de renderizado y el DOM?

El DOM contiene todos los nodos del documento, incluido lo que nunca se mostrará: el contenido de head y los elementos ocultos con display:none. El árbol de renderizado contiene solo lo que se va a pintar, con sus estilos calculados. Un elemento con visibility:hidden es un caso límite útil: sigue en el árbol de renderizado y ocupa su espacio, simplemente no se pinta.

¿Cómo sé qué etapa es mi cuello de botella?

Lee una cascada en una herramienta de laboratorio y busca lo que espera, no lo que es grande. Una espera larga antes de la primera petición apunta al servidor, es decir, al TTFB. Un primer pintado que llega mucho después de que termine el HTML apunta a una hoja de estilo o un script que bloquea el renderizado. Los costes de maquetación y pintado aparecen como tareas largas en la traza del hilo principal una vez llegados los recursos.

Stack relacionado