CKTIS / JavaScript
DOMContentLoaded — disponibilidade da árvore DOM
DOMContentLoaded assinala que a análise do HTML e a execução dos scripts diferidos terminaram. Permite inicializar uma interface sem esperar pelo carregamento completo da página.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded é um evento acionado em document depois de terminar a análise do HTML e a execução dos scripts diferidos. Faz parte da norma HTML, não de ECMAScript; os motores dos browsers atuais suportam-no. A presença de Node 24, por si só, não disponibiliza o document do browser.
Não significa que todos os recursos tenham sido carregados: não espera pelas imagens nem pelos scripts async. O evento posterior load em window corresponde a uma fase de carregamento mais completa. As folhas de estilo podem atrasar indiretamente DOMContentLoaded ao bloquearem a execução dos scripts diferidos.
Um listener adicionado depois do evento não é executado retroativamente. Por isso, o exemplo verifica document.readyState: se o valor for "loading", regista init; caso contrário, chama-a de imediato. O estado "interactive" significa que a análise terminou, mas não prova que DOMContentLoaded já tenha sido acionado. Este padrão trata da disponibilidade do DOM; não garante que se espere pelos scripts diferidos que ainda estejam pendentes.
No exemplo, o script surge antes do parágrafo. A espera evita procurar o elemento demasiado cedo; após a inicialização, tanto o parágrafo como a consola mostram DOM ready.
Exemplos
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>DOMContentLoaded example</title>
<script>
function init() {
document.getElementById("status").textContent = "DOM ready";
console.log("DOM ready");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
</script>
</head>
<body>
<p id="status">Waiting</p>
</body>
</html>Resultado
DOM ready
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.