Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DOMContentLoaded, pagehide a pageshow: připravenost DOM a navigace

Rozlišujte dokončení zpracování DOM, opuštění dokumentu a jeho obnovení. Naučte se, co jednotlivé hodnoty `readyState` a `persisted` v těchto situacích znamenají.

Verze: ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

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 událost prohlížeče typu Event, kterou poslouchejte na document. Nastane po dokončení zpracování HTML a provedení klasických skriptů s defer. Před vyvoláním události prohlížeč také zahájí vyhodnocování modulových skriptů bez async, které vložil analyzátor HTML. Nečeká však na dokončení operací, na které čeká await na nejvyšší úrovni těchto modulů nebo jejich závislostí. Inicializace modulů proto nemusí být dokončena ani po vyvolání události. Nečeká na obrázky, rámce ani skripty s async; styly ji mohou nepřímo zpozdit, pokud blokují odložené skripty. Není to událost load.

Pokud se kód může spustit pozdě a stačí mu DOM vytvořený při zpracování HTML, zkontrolujte document.readyState. Při hodnotě "loading" přidejte jednorázového posluchače DOMContentLoaded; jinak inicializujte hned. Hodnota "interactive" znamená, že zpracování HTML skončilo, ne že už nastala událost DOMContentLoaded nebo že jiné skripty dokončily inicializaci.

Na window poslouchejte pagehide při opuštění dokumentu a pageshow při jeho načtení nebo obnovení. Obě události jsou typu PageTransitionEvent s logickou vlastností persisted. U pagehide znamená true, že dokument lze znovu použít, nikoli že se to určitě stane; false znamená, že se znovu nepoužije. Při novém načtení nastane pageshow po load s hodnotou false. Při obnovení z mezipaměti pro navigaci zpět a vpřed (bfcache) má hodnotu true: vrátí se stejný DOM i stav JavaScriptu bez další události DOMContentLoaded.

Při pagehide pozastavte úlohy stránky a při pageshow s persisted === true je obnovte nebo aktualizujte zastaralá data. pagehide nemusí nastat, například při ukončení mobilního prohlížeče na pozadí. Důležité změny ukládejte průběžně; viditelnost sledujte pomocí visibilitychange a document.visibilityState. Tyto události neoznamují běžné přepnutí karty a patří do webové platformy, nikoli do ECMAScriptu.

Příklady

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

Výsledek

DOM ready

Po úplném načtení stránky vložte kód jednou do konzole prohlížeče. Výpis `DOM ready` pochází z kontroly `readyState`, nikoli z opakované události. Zachovejte výpisy konzole, přejděte na jiný dokument na stejné kartě a vraťte se zpět. Další řádky závisí na navigaci a na tom, zda prohlížeč použije bfcache.

Související lekce

  • JavaScript · Lekce 37 · Pokročilá · Verze: 4

Zdroje