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

CKTIS / JavaScript

Dogodka DOMContentLoaded in pagehide

Uporabi `DOMContentLoaded` za inicializacijo kode, ko je DOM zgrajen, in `pagehide` za začasno prekinitev dela ob zapuščanju dokumenta. Obnovitev iz bfcache ni novo nalaganje.

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

Sintaksa

document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);

DOMContentLoaded je dogodek tipa Event na document, ki se sproži, ko brskalnik konča razčlenjevanje HTML-ja, izvede klasične skripte z defer in začne vrednotiti modulske skripte brez async, predvidene za konec razčlenjevanja. Dogodek ne čaka na konec vrednotenja modulov: če se izvajanje odvisnega modula začasno ustavi pri await na najvišji ravni, se lahko sproži, še preden se začne izvajati telo modula, ki ga uvaža. Ne čaka na slike, okvirje ali konec izvajanja skript async. Slogovne predloge ga lahko posredno zakasnijo, če blokirajo izvajanje skript. Če moraš počakati na vire, ki zadržujejo nalaganje strani, uporabi load na window.

Če se inicializacijska koda lahko zažene pozno, preveri document.readyState: pri "loading" registriraj enkratni poslušalnik za DOMContentLoaded, sicer uporabi že razpoložljivi DOM. "interactive" pomeni, da je razčlenjevanje končano, ne pa nujno, da se je dogodek že sprožil ali da so druge skripte končale inicializacijo. Če je tvoja koda odvisna od tega, izrecno določi vrstni red inicializacije.

Na window poslušaj pagehide, ko brskalnik zapušča dokument, na primer pri vrnitvi na prejšnjo stran. Ta PageTransitionEvent ne pomeni zgolj preklopa med zavihki in z njim navigacije ni mogoče preklicati. event.persisted === true pomeni, da se dokument lahko ohrani v predpomnilniku za premikanje nazaj in naprej (bfcache), ne pa da bo obnovitev zagotovo uspela. false pomeni, da se dokument pri tem prehodu ne ohrani. Začasno prekini delo ob pagehide in ga nadaljuj ob pageshow z persisted === true: obnovljeni dokument obdrži svoj DOM in ne sproži znova dogodka DOMContentLoaded.

Pomembne podatke shranjuj sproti. pagehide se lahko izpusti, zlasti ob prisilnem zaprtju mobilnega brskalnika, in asinhrono delo, začeto takrat, se morda ne bo končalo. Ko želiš zaznati, da je stran postala skrita, poslušaj visibilitychange na document in preveri stanje "hidden". To so API-ji spletne platforme, ne novosti v ECMAScriptu 2024.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>DOMContentLoaded and pagehide</title>
  <script>
    (() => {
      const init = () => console.log("DOM ready");

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

      window.addEventListener("pagehide", (event) => {
        console.log(`pagehide persisted=${event.persisted}`);
      });

      window.addEventListener("pageshow", (event) => {
        if (event.persisted) console.log("pageshow restored");
      });
    })();
  </script>
</head>
<body>
  <p>Open the browser console to see the event log.</p>
</body>
</html>

Rezultat

DOM ready

Primer shrani kot datoteko HTML in jo odpri v brskalniku. V konzoli vklopi ohranjanje dnevnika in znova naloži stran. `DOM ready` se izpiše, ko se sproži `DOMContentLoaded`. Poznejša sporočila so odvisna od navigacije in od tega, ali brskalnik dokument obdrži.

Povezane lekcije

  • JavaScript · Lekcija 40 · Napredna · Različica: 4
  • JavaScript · Lekcija 41 · Napredna · Različica: 4

Viri