CKTIS / JavaScript
DOMContentLoaded — pripravljenost drevesa DOM
DOMContentLoaded označuje, da sta razčlenjevanje HTML-ja in izvajanje odloženih skriptov končana. Omogoča inicializacijo vmesnika, ne da bi čakali na popolno nalaganje strani.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.addEventListener("DOMContentLoaded", init, { once: true });DOMContentLoaded je dogodek, ki se sproži na document, ko sta razčlenjevanje HTML-ja in izvajanje odloženih skriptov končana. Spada v standard HTML, ne v ECMAScript; podpirajo ga sodobni brskalniški pogoni. Sama prisotnost Node 24 ne zagotavlja brskalniškega document.
Ne pomeni, da so naloženi vsi viri: ne čaka na slike ali skripte async. Poznejši dogodek load na window pomeni naprednejšo fazo nalaganja. Slogovne datoteke lahko posredno zakasnijo DOMContentLoaded, ker blokirajo izvajanje odloženih skriptov.
Poslušalnik, dodan po dogodku, se ne izvede za nazaj. Zato primer preveri document.readyState: če je njegova vrednost "loading", registrira init; sicer jo takoj pokliče. Stanje "interactive" pomeni, da je razčlenjevanje končano, vendar ne dokazuje, da se je DOMContentLoaded že sprožil. Ta vzorec obravnava pripravljenost DOM-a; ne zagotavlja čakanja na preostale odložene skripte.
Skript je v primeru pred odstavkom. Čakanje prepreči prezgodnje iskanje elementa; po inicializaciji tako odstavek kot konzola prikažeta DOM ready.
Primeri
<!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>Rezultat
DOM ready
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.