Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMContentLoaded — disponibilità dell’albero DOM

DOMContentLoaded segnala che l’analisi dell’HTML e l’esecuzione degli script differiti sono terminate. Permette di inizializzare un’interfaccia senza aspettare il caricamento completo della pagina.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

document.addEventListener("DOMContentLoaded", init, { once: true });

DOMContentLoaded è un evento attivato su document dopo il termine dell’analisi dell’HTML e dell’esecuzione degli script differiti. Fa parte dello standard HTML, non di ECMAScript; i motori dei browser attuali lo supportano. La sola presenza di Node 24 non fornisce il document del browser.

Non significa che tutte le risorse siano state caricate: non aspetta le immagini né gli script async. Il successivo evento load su window corrisponde a una fase di caricamento più completa. I fogli di stile possono ritardare indirettamente DOMContentLoaded bloccando l’esecuzione degli script differiti.

Un listener aggiunto dopo l’evento non viene eseguito retroattivamente. Perciò l’esempio controlla document.readyState: se il valore è "loading", registra init; altrimenti la chiama subito. Lo stato "interactive" indica che l’analisi è terminata, ma non dimostra che DOMContentLoaded sia già stato attivato. Questo schema gestisce la disponibilità del DOM; non garantisce l’attesa degli script differiti ancora in sospeso.

Nell’esempio lo script precede il paragrafo. L’attesa evita di cercare l’elemento troppo presto; dopo l’inizializzazione, sia il paragrafo sia la console mostrano DOM ready.

Esempi

<!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>

Risultato

DOM ready

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti