CKTIS / JavaScript
Document.readyState — stav načítání dokumentu
Document.readyState popisuje fázi načítání dokumentu: loading, interactive nebo complete. Kontrola této vlastnosti pomáhá inicializovat kód související s DOM i tehdy, když se skript načte příliš pozdě na zachycení události DOMContentLoaded.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.readyStateDocument.readyState, čtené jako document.readyState, popisuje aktuální stav načítání dokumentu. Jde o Web API prohlížeče, nikoli o funkci jazyka ECMAScript. MDN jej klasifikuje jako široce dostupné v prohlížečích od července 2015; samotná verze Node.js nedokládá podporu tohoto API.
Hodnota "loading" znamená, že HTML parser stále pracuje. Ve stavu "interactive" je dokument již zpracován, ale závislé prostředky se mohou stále načítat. Dokument přejde do stavu "complete", jakmile je načtený a žádný prostředek už neoddaluje událost load. Událost load se vyvolá po tomto přechodu. Obrázky s loading="lazy" ještě nemusí být načtené, protože tuto událost neoddalují. Změna stavu vyvolá na dokumentu událost readystatechange.
Stav "interactive" neznamená, že událost DOMContentLoaded již nastala: klasické skripty s defer a modulové skripty, které se mají spustit po zpracování dokumentu, mohou stále čekat na spuštění. Před vyvoláním události prohlížeč provede tyto klasické skripty a zahájí vyhodnocování těchto modulů. Nečeká však na dokončení modulu pozastaveného na příkazu await na nejvyšší úrovni ani na modulové skripty s async či na obrázky. Připravený DOM tedy neznamená, že je stránka plně načtená.
Příklad čeká na DOMContentLoaded pouze ve stavu "loading"; jinak ihned zavolá init(). Pozdě spuštěný skript tak nečeká na událost, která již proběhla. Tento vzor umožňuje přístup ke zpracovanému DOM, nezaručuje však dokončení ostatních skriptů defer nebo modulových skriptů. { once: true } odebere posluchač po prvním vyvolání.
Příklady
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Výsledek
DOM parsed
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.