Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Document.readyState — stav načítania dokumentu

Document.readyState opisuje fázu načítania dokumentu: loading, interactive alebo complete. Kontrola tejto vlastnosti pomáha inicializovať kód súvisiaci s DOM aj vtedy, keď sa skript načíta príliš neskoro na zachytenie udalosti DOMContentLoaded.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

document.readyState

Document.readyState, čítané ako document.readyState, opisuje aktuálny stav načítania dokumentu. Ide o Web API prehliadača, nie o funkciu jazyka ECMAScript. MDN ho klasifikuje ako široko dostupné v prehliadačoch od júla 2015; samotná verzia Node.js nedokazuje podporu tohto API.

Hodnota "loading" znamená, že HTML parser stále pracuje. V stave "interactive" je dokument už spracovaný, ale závislé zdroje sa môžu stále načítavať. Dokument prejde do stavu "complete", keď je načítaný a žiadny zdroj už neodďaľuje udalosť load. Udalosť load sa vyvolá po tomto prechode. Obrázky s loading="lazy" ešte nemusia byť načítané, pretože túto udalosť neodďaľujú. Zmena stavu vyvolá na dokumente udalosť readystatechange.

Stav "interactive" neznamená, že udalosť DOMContentLoaded už nastala: klasické skripty s defer a modulové skripty, ktoré sa majú spustiť po spracovaní dokumentu, môžu ešte čakať na spustenie. Pred vyvolaním udalosti prehliadač vykoná tieto klasické skripty a začne vyhodnocovať tieto moduly. Nečaká však na dokončenie modulu pozastaveného pri await na najvyššej úrovni ani na modulové skripty s async či na obrázky. Pripravený DOM teda neznamená, že je stránka úplne načítaná.

Príklad čaká na DOMContentLoaded iba v stave "loading"; v ostatných prípadoch okamžite zavolá init(). Neskoro spustený skript tak nečaká na udalosť, ktorá už nastala. Tento vzor umožňuje prístup k spracovanému DOM, nezaručuje však dokončenie ostatných skriptov defer alebo modulových skriptov. { once: true } odstráni poslucháča po prvom vyvolaní.

Príklady

(() => {
  function init() {
    console.log("DOM parsed");
  }

  if (document.readyState === "loading") {
    document.addEventListener("DOMContentLoaded", init, { once: true });
  } else {
    init();
  }
})();

Výsledok

DOM parsed

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje