Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Document.readyState — stanje nalaganja dokumenta

Document.readyState opisuje fazo nalaganja dokumenta: loading, interactive ali complete. Preverjanje te lastnosti pomaga inicializirati kodo, povezano z DOM, tudi kadar se skript naloži prepozno, da bi prejel DOMContentLoaded.

Različica: 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.readyState

Document.readyState, prebran kot document.readyState, opisuje trenutno stanje nalaganja dokumenta. Gre za spletni API brskalnika, ne za funkcijo jezika ECMAScript. MDN ga uvršča med široko podprte v brskalnikih od julija 2015; sama različica Node.js ne dokazuje podpore za ta API.

Vrednost "loading" pomeni, da razčlenjevalnik HTML še deluje. Pri stanju "interactive" je dokument že razčlenjen, vendar se odvisni viri morda še nalagajo. Dokument preide v stanje "complete", ko je naložen in noben vir več ne zadržuje sprožitve dogodka load. Dogodek load se sproži po tem prehodu. Slike z atributom loading="lazy" takrat morda še niso naložene, saj ne zadržujejo sprožitve tega dogodka. Sprememba stanja sproži readystatechange na dokumentu.

Stanje "interactive" ne pomeni, da se je DOMContentLoaded že sprožil: klasični skripti z atributom defer in modulski skripti, predvideni za izvedbo po razčlenjevanju dokumenta, morda še čakajo na izvedbo. Preden brskalnik sproži dogodek, izvede te klasične skripte in začne vrednotiti te module. Ne čaka na konec vrednotenja modula, ki je začasno ustavljeno pri await na najvišji ravni, niti na modulske skripte z atributom async ali na slike. Pripravljen DOM torej ne pomeni, da je stran v celoti naložena.

Primer čaka na DOMContentLoaded samo pri stanju "loading"; sicer takoj pokliče init(). Tako pozno izvedeni skript ne čaka na dogodek, ki se je že zgodil. Ta vzorec omogoča dostop do razčlenjenega DOM, ne zagotavlja pa, da so se drugi skripti defer ali skripti modulov že končali. { once: true } odstrani poslušalnik po prvem klicu.

Primeri

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

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

Rezultat

DOM parsed

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri