CKTIS / JavaScript
Document.readyState — stan ładowania dokumentu
Document.readyState opisuje etap ładowania dokumentu: loading, interactive albo complete. Sprawdzenie tej właściwości pomaga uruchomić inicjalizację DOM także wtedy, gdy skrypt został załadowany zbyt późno, aby odebrać DOMContentLoaded.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
document.readyStateDocument.readyState, odczytywane jako document.readyState, opisuje bieżący stan ładowania dokumentu. Jest to interfejs Web API przeglądarki, a nie funkcja języka ECMAScript. MDN klasyfikuje go jako szeroko dostępny w przeglądarkach od lipca 2015 r.; sama wersja Node.js nie potwierdza obsługi tego API.
Wartość "loading" oznacza, że parser HTML nadal pracuje. Przy "interactive" dokument jest już sparsowany, ale zasoby zależne mogą nadal się ładować. Dokument osiąga stan "complete", gdy jego ładowanie się zakończyło i żaden zasób nie opóźnia już zdarzenia load. Zdarzenie load następuje po przejściu do tego stanu. Obrazy z loading="lazy" mogą nadal czekać na załadowanie, ponieważ nie opóźniają tego zdarzenia. Zmiana stanu wywołuje readystatechange na dokumencie.
Stan "interactive" nie oznacza, że zdarzenie DOMContentLoaded już wystąpiło: klasyczne skrypty z defer i skrypty modułowe zaplanowane do wykonania po parsowaniu mogą jeszcze czekać na uruchomienie. Przed wywołaniem zdarzenia przeglądarka wykonuje te klasyczne skrypty i rozpoczyna wykonywanie modułów. Nie czeka jednak na zakończenie wykonywania modułu wstrzymanego przez await na najwyższym poziomie ani na skrypty modułowe z async czy na obrazy. Gotowość DOM nie oznacza więc pełnego załadowania strony.
Przykład czeka na DOMContentLoaded tylko przy "loading"; w pozostałych stanach wykonuje init() od razu. Dzięki temu późno uruchomiony skrypt nie czeka na zdarzenie, które już minęło. Ten wzorzec zapewnia dostęp do sparsowanego DOM, ale nie gwarantuje zakończenia innych skryptów defer lub modułowych. { once: true } usuwa nasłuchiwanie po pierwszym wywołaniu.
Przykłady
(() => {
function init() {
console.log("DOM parsed");
}
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}
})();Wynik
DOM parsed
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.