Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

blocking: retrasar el renderizado por un recurso

Distingue el bloqueo del renderizado del análisis de HTML y del orden de ejecución de scripts.

Versión: HTML Living Standard

Sintaxis

<script async blocking="render" src="/gate.js"></script>

El atributo blocking es una lista de tokens separados por espacios en los elementos de script, enlace de hoja de estilo y estilo que lo admiten. El token definido actualmente, render, solicita que el renderizado espere mientras el recurso sea bloqueante. Importan la ubicación y las reglas de procesamiento de cada elemento; un script destinado a bloquear el renderizado inicial pertenece a la cabecera del documento. Es una decisión de rendimiento, no una restricción de seguridad del código.

Bloquear el renderizado no es bloquear el analizador. Un script externo con async puede descargarse sin detener el análisis de HTML y, por separado, retrasar el primer renderizado. El atributo no establece un orden de dependencias entre scripts independientes. Añadirlo indiscriminadamente puede dejar la página en blanco más tiempo; resérvalo para recursos que realmente deban estar listos antes de mostrarla.

El entorno local retiene deliberadamente el script externo hasta que termina el análisis del DOM. El script comprueba entonces que todavía no hay entradas de pintado y proporciona el resultado. La prueba también confirma que se produce un primer pintado con contenido después de liberarlo. Verifica este caso controlado en Chromium 145, no garantías de tiempo para todas las redes o navegadores.

Ejemplos

<!doctype html><html><head><meta charset="utf-8">
<script>
window.parserFinished = false;
document.addEventListener('DOMContentLoaded', () => { window.parserFinished = true; });
window.recordGate = () => {
  document.querySelector('#result').textContent = 'parserFinished=' + window.parserFinished + '; paintCountBeforeScript=' + performance.getEntriesByType('paint').length;
};
</script>
<!-- Local server holds this response until DOMContentLoaded, then sends window.recordGate(); -->
<script async blocking="render" src="/gate.js"></script>
</head><body><h1>Content waiting to be painted</h1><output id="result"></output></body></html>

Resultado

parserFinished=true; paintCountBeforeScript=0

El servidor de prueba asociado devuelve el script documentado de una línea después de DOMContentLoaded; no es un servicio externo.

Fuentes