Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

defer: scripts clássicos depois da análise

Mantenha a ordem documental sem parar a análise HTML durante a transferência.

Versão: HTML Living Standard

Sintaxe

<script defer src="/first.js"></script>

Para scripts clássicos externos inseridos pelo analisador, o booleano defer permite transferência paralela e adia a execução até terminar a análise HTML. Executam pela ordem do documento antes de DOMContentLoaded. Não adia um script clássico escrito diretamente no elemento. Os módulos já são diferidos por predefinição e não mudam com este atributo.

Se também existir async, esse comportamento tem prioridade nos navegadores modernos. Diferido não significa período inativo ou thread em segundo plano: um script longo ainda pode bloquear a interação. Não aplique sem verificar esta regra aos scripts criados dinamicamente.

O servidor de teste entrega propositadamente o segundo ficheiro antes do primeiro. Apesar disso executam pela ordem documental; o primeiro encontra um elemento no fim e DOMContentLoaded ocorre depois. Verificam-se pedidos e sequência real com respostas locais.

Exemplos

<!doctype html><html><head><meta charset="utf-8">
<script>window.order = []; document.addEventListener('DOMContentLoaded', () => { window.order.push('DOMContentLoaded'); document.querySelector('#result').textContent = window.order.join(','); });</script>
<!-- Local fixture: first.js is held until #tail exists; second.js arrives earlier. -->
<script defer src="/first.js"></script><script defer src="/second.js"></script>
</head><body><p id="tail">Parsed content</p><output id="result"></output></body></html>

Resultado

first:true,second,DOMContentLoaded

Só a primeira resposta é retida de propósito; o navegador produz a ordem registada.

Fontes