CKTIS / JavaScript
Document.readyState — stanje učitavanja dokumenta
Document.readyState opisuje fazu učitavanja dokumenta: loading, interactive ili complete. Provjera tog svojstva pomaže pri inicijalizaciji koda povezanog s DOM-om čak i kada se skripta učita prekasno da bi primila DOMContentLoaded.
Verzija: 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.readyStateDocument.readyState, čitan kao document.readyState, opisuje trenutačno stanje učitavanja dokumenta. To je web-API preglednika, a ne značajka jezika ECMAScript. MDN ga klasificira kao široko dostupan u preglednicima od srpnja 2015.; sama verzija Node.js-a ne potvrđuje podršku za taj API.
Vrijednost "loading" znači da HTML parser još radi. U stanju "interactive" dokument je već parsiran, no ovisni se resursi možda još učitavaju. Dokument prelazi u stanje "complete" kad se učita i nijedan resurs više ne odgađa događaj load. Događaj load pokreće se nakon tog prijelaza. Slike s atributom loading="lazy" tada još ne moraju biti učitane jer ne odgađaju taj događaj. Promjena stanja pokreće readystatechange na dokumentu.
Stanje "interactive" ne znači da se DOMContentLoaded već pokrenuo: klasične skripte s atributom defer i modulske skripte predviđene za izvršavanje nakon parsiranja dokumenta možda još čekaju na izvršavanje. Prije nego što pokrene događaj, preglednik izvršava te klasične skripte i započinje evaluaciju tih modula. Ne čeka da završi evaluacija modula zaustavljena na izrazu await na najvišoj razini, niti čeka modulske skripte s atributom async ili slike. Spreman DOM stoga ne znači da je stranica potpuno učitana.
Primjer čeka na DOMContentLoaded samo kada je stanje "loading"; u suprotnom odmah poziva init(). Tako skripta koja se pokrene kasno ne čeka događaj koji se već dogodio. Ovaj obrazac omogućuje pristup parsiranom DOM-u, ali ne jamči da su druge skripte defer ili skripte modula završile. { once: true } uklanja slušatelj nakon prvog poziva.
Primjeri
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Rezultat
DOM parsed
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.