Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMContentLoaded, pagehide i pageshow: spremnost DOM-a i navigacija

Razlikuj spremnost DOM-a, napuštanje dokumenta i njegovu obnovu. Saznaj kako protumačiti `readyState` i `persisted` te zašto nisu pokazatelji vidljivosti stranice.

Verzija: 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 događaj preglednika tipa Event koji slušaš na objektu document. Aktivira se nakon završetka raščlambe HTML-a i izvršavanja klasičnih skripti s defer. Prije aktiviranja događaja preglednik pokreće i evaluaciju modulskih skripti bez async koje je umetnuo raščlanjivač HTML-a. Ne čeka dovršetak operacija koje await na najvišoj razini čeka u tim modulima ili njihovim ovisnostima, pa inicijalizacija modula može ostati nedovršena i nakon događaja. Ne čeka slike, okvire ni skripte s async; stilske tablice mogu ga neizravno odgoditi ako blokiraju odgođene skripte. To nije događaj load.

Ako se kôd može pokrenuti kasno i treba mu samo DOM izgrađen raščlambom HTML-a, provjeri document.readyState. Ako je vrijednost "loading", dodaj jednokratni slušač za DOMContentLoaded; inače odmah pokreni inicijalizaciju. "interactive" znači da je raščlamba završena, a ne da se DOMContentLoaded već aktivirao ili da su druge skripte dovršile inicijalizaciju.

Na objektu window slušaj pagehide pri napuštanju dokumenta i pageshow pri njegovom učitavanju ili obnovi. Oba su događaja tipa PageTransitionEvent s logičkim svojstvom persisted. Za pagehide, true znači da se dokument može ponovno upotrijebiti, bez jamstva; false znači da se neće ponovno upotrijebiti. Pri novom učitavanju pageshow slijedi nakon load s vrijednošću false. Pri obnovi iz predmemorije za navigaciju natrag i naprijed (bfcache) vrijednost je true: vraćaju se isti DOM i isto stanje JavaScripta bez ponovnog DOMContentLoaded.

Upotrijebi pagehide za pauziranje zadataka stranice, a pageshow uz persisted === true za nastavak tih zadataka ili osvježavanje zastarjelih podataka. pagehide može izostati, primjerice ako se mobilni preglednik prisilno zatvori u pozadini. Važne promjene spremaj čim nastanu; promjene vidljivosti prati uz visibilitychange i document.visibilityState. Ti događaji ne označavaju običnu promjenu kartice i pripadaju web-platformi, a ne ECMAScriptu.

Primjeri

(() => {
  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

Zalijepi kôd jednom u konzolu preglednika nakon potpunog učitavanja stranice. Ispis `DOM ready` tada dolazi od provjere `readyState`, a ne od ponovljenog događaja. Zadrži zapise konzole, prijeđi na drugi dokument na istoj kartici i vrati se natrag. Dodatni redci ovise o navigaciji i o tome koristi li preglednik bfcache.

Povezane lekcije

  • JavaScript · Lekcija 37 · Napredno · Verzija: 4

Izvori