Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.readyState

Document.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.

Źródła