Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Udalosti DOMContentLoaded a pagehide

Použi `DOMContentLoaded` na inicializáciu kódu po vytvorení DOM a `pagehide` na pozastavenie práce pri opustení dokumentu. Obnovenie z bfcache nie je nové načítanie.

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

Syntax

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

DOMContentLoaded je udalosť typu Event vyvolaná na document po tom, ako prehliadač dokončí spracovanie HTML, vykoná klasické skripty s defer a začne vyhodnocovať modulové skripty bez async naplánované na koniec spracovania. Udalosť nečaká na dokončenie vyhodnocovania modulov: ak sa vykonávanie niektorej závislosti pozastaví na await na najvyššej úrovni, udalosť môže nastať ešte pred začiatkom vykonávania tela modulu, ktorý ju importuje. Nečaká na obrázky, rámce ani dokončenie skriptov async. Štýly ju môžu nepriamo oneskoriť, ak blokujú vykonávanie skriptov. Ak potrebuješ počkať na zdroje, ktoré oneskorujú načítanie stránky, použi load na window.

Ak sa inicializačný kód môže spustiť neskoro, skontroluj document.readyState: pri hodnote "loading" zaregistruj jednorazový poslucháč udalosti DOMContentLoaded, inak použi už dostupný DOM. "interactive" znamená, že spracovanie HTML skončilo, nie že udalosť už nastala alebo že iné skripty dokončili inicializáciu. Ak od nej závisíš, výslovne urči poradie inicializácie.

Udalosť pagehide sleduj na window pri opustení dokumentu, napríklad pri návrate späť. Tento PageTransitionEvent neoznamuje obyčajné prepnutie karty a nedá sa ním zrušiť navigácia. event.persisted === true znamená, že dokument môže zostať v medzipamäti pre navigáciu späť a dopredu (bfcache), nie že jeho obnovenie je zaručené. false znamená, že sa pri tejto navigácii nezachová. Pri pagehide prácu pozastav a obnov ju pri pageshow s persisted === true: obnovený dokument si ponechá svoj DOM a DOMContentLoaded sa nevyvolá znova.

Dôležité údaje ukladaj priebežne. pagehide nemusí nastať najmä pri vynútenom ukončení mobilného prehliadača a asynchrónne operácie spustené v tomto okamihu sa nemusia dokončiť. Na skrytie stránky reaguj pomocou visibilitychange na document a kontroluj stav "hidden". Ide o API webovej platformy, nie o novinky ECMAScriptu 2024.

Príklady

<!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>

Výsledok

DOM ready

Ulož príklad ako súbor HTML a otvor ho v prehliadači. V konzole zapni zachovanie výpisu a načítaj stránku znova. `DOM ready` sa zobrazí pri vyvolaní `DOMContentLoaded`. Ďalšie správy závisia od navigácie a od toho, či prehliadač dokument zachová.

Súvisiace lekcie

  • JavaScript · Lekcia 40 · Pokročilá · Verzia: 4
  • JavaScript · Lekcia 41 · Pokročilá · Verzia: 4

Zdroje