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

CKTIS / JavaScript

DOMContentLoaded, pagehide in pageshow: pripravljenost DOM-a in krmarjenje

Loči med pripravljenostjo DOM-a, zapustitvijo dokumenta in njegovo obnovitvijo. Ugotovi, kaj `readyState` in `persisted` povesta o nalaganju in ponovni uporabi dokumenta.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);
// onPageHide and onPageShow receive a PageTransitionEvent with a boolean persisted property.

DOMContentLoaded je dogodek brskalnika tipa Event, ki ga poslušaš na document. Sproži se po končanem razčlenjevanju HTML-ja in izvedbi klasičnih skriptov z defer. Pred sprožitvijo dogodka brskalnik začne tudi vrednotenje modulskih skriptov brez async, ki jih je vstavil razčlenjevalnik HTML-ja. Ne čaka pa na dokončanje operacij, na katere čaka await na vrhnji ravni teh modulov ali njihovih odvisnosti. Inicializacija modulov zato tudi po dogodku še ni nujno končana. Ne čaka na slike, okvirje ali skripte z async; slogovne predloge ga lahko posredno zakasnijo, če blokirajo odložene skripte. To ni dogodek load.

Če se koda lahko izvede pozno in potrebuje samo DOM, zgrajen z razčlenitvijo HTML-ja, preveri document.readyState. Pri "loading" dodaj enkratni poslušalec za DOMContentLoaded, sicer takoj izvedi inicializacijo. "interactive" pomeni, da je razčlenjevanje končano, ne pa, da se je DOMContentLoaded že sprožil ali da so drugi skripti končali inicializacijo.

Na window poslušaj pagehide ob zapustitvi dokumenta in pageshow ob nalaganju ali obnovitvi dokumenta. Oba sta dogodka tipa PageTransitionEvent z logično lastnostjo persisted. Pri pagehide vrednost true pomeni, da je ponovna uporaba dokumenta možna, ne pa zagotovljena; false pomeni, da dokument ne bo ponovno uporabljen. Pri novem nalaganju sledi pageshow dogodku load z vrednostjo false. Pri obnovitvi iz predpomnilnika za krmarjenje nazaj in naprej (bfcache) ima vrednost true: obnovita se isti DOM in isto stanje JavaScripta brez ponovnega DOMContentLoaded.

Z pagehide začasno ustavi opravila strani, s pageshow in persisted === true pa jih nadaljuj ali osveži zastarele podatke. pagehide se morda ne sproži, na primer če se mobilni brskalnik v ozadju zapre. Pomembne spremembe shranjuj sproti; vidnost spremljaj z visibilitychange in document.visibilityState. Ti dogodki ne označujejo navadnega preklopa zavihka in so del spletne platforme, ne ECMAScripta.

Primeri

(() => {
  function installListeners(doc, win) {
    const onDomReady = () => console.log("DOM ready");
    if (doc.readyState === "loading") {
      doc.addEventListener("DOMContentLoaded", onDomReady, { once: true });
    } else {
      onDomReady();
    }

    const logTransition = (event) => {
      console.log(`${event.type} persisted=${event.persisted}`);
    };
    win.addEventListener("pagehide", logTransition);
    win.addEventListener("pageshow", logTransition);
  }

  if (typeof document !== "undefined" && typeof window !== "undefined") {
    installListeners(document, window);
  } else {
    // Node.js test: simulate DOM readiness without simulating navigation.
    const testDocument = new EventTarget();
    const testWindow = new EventTarget();
    testDocument.readyState = "loading";
    installListeners(testDocument, testWindow);
    testDocument.readyState = "interactive";
    testDocument.dispatchEvent(new Event("DOMContentLoaded"));
  }
})();

Rezultat

DOM ready

Ko je stran naložena v celoti, enkrat prilepi kodo v konzolo brskalnika. Izpis `DOM ready` takrat izhaja iz preverjanja `readyState`, ne iz ponovitve dogodka. Ohrani dnevnik konzole, v istem zavihku odpri drug dokument in se vrni nazaj. Dodatne vrstice so odvisne od krmarjenja in od tega, ali brskalnik uporabi bfcache.

Povezane lekcije

  • JavaScript · Lekcija 37 · Napredna · Različica: 4

Viri