CKTIS / HTML
blocking: adiar a apresentação por causa de um recurso
Distingue o bloqueio da apresentação da análise de HTML e da ordem de execução dos scripts.
Versão: HTML Living Standard
Sintaxe
<script async blocking="render" src="/gate.js"></script>O atributo blocking é uma lista de tokens separados por espaços nos elementos de script, ligação a folha de estilos e estilo que o admitem. O token atualmente definido, render, pede que a apresentação espere enquanto o recurso for bloqueante. A posição e as regras de processamento de cada elemento importam; um script destinado a bloquear a apresentação inicial pertence ao cabeçalho do documento. É uma escolha de desempenho, não uma restrição de segurança do código.
Bloquear a apresentação é diferente de bloquear o analisador. Um script externo com async pode ser transferido sem interromper a análise de HTML e, separadamente, atrasar a primeira apresentação. O atributo não estabelece uma ordem de dependências entre scripts independentes. Acrescentá-lo indiscriminadamente pode deixar a página vazia durante mais tempo; reserva-o para recursos que realmente têm de estar prontos antes da visualização.
O ambiente local retém deliberadamente o script externo até terminar a análise do DOM. O script observa então que ainda não existem registos de pintura e fornece o resultado. O teste também confirma uma primeira pintura com conteúdo depois da libertação. Verifica este caso controlado em Chromium 145, não garantias temporais para todas as redes ou navegadores.
Exemplos
<!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
O servidor de teste associado devolve o script documentado de uma linha após DOMContentLoaded; não é um serviço externo.