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

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.

Fontes