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.