CKTIS / JavaScript
Události DOMContentLoaded a pagehide
Použijte `DOMContentLoaded` k inicializaci kódu po vytvoření DOM a `pagehide` k pozastavení práce při opuštění dokumentu. Obnovení z bfcache není nové načtení.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
document.addEventListener("DOMContentLoaded", onReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("pageshow", onPageShow);DOMContentLoaded je událost typu Event vyvolaná na document poté, co prohlížeč dokončí zpracování HTML, provede klasické skripty s defer a zahájí vyhodnocování modulových skriptů bez async naplánovaných na konec zpracování. Událost nečeká na dokončení vyhodnocování modulů: pokud se provádění závislého modulu pozastaví na await na nejvyšší úrovni, může nastat ještě před spuštěním kódu modulu, který jej importuje. Nečeká na obrázky, rámce ani na dokončení skriptů async. Styly ji mohou nepřímo zpozdit, pokud blokují spouštění skriptů. Pokud potřebujete počkat na zdroje, které zdržují načítání stránky, použijte load na window.
Pokud se inicializační kód může spustit pozdě, zkontrolujte document.readyState: při hodnotě "loading" přidejte jednorázového posluchače DOMContentLoaded, jinak použijte již dostupný DOM. "interactive" označuje konec zpracování HTML, nikoli jistotu, že událost již proběhla nebo že ostatní skripty dokončily inicializaci. Pokud na jejich inicializaci závisíte, stanovte pořadí výslovně.
Událost pagehide poslouchejte na window při opuštění dokumentu, například při návratu zpět. Tento PageTransitionEvent neoznamuje pouhé přepnutí karty a nelze jím zrušit navigaci. event.persisted === true znamená, že dokument může být zachován v mezipaměti pro navigaci zpět a vpřed (bfcache), ne že je jeho obnovení zaručeno. false znamená, že se při této navigaci nezachovává. Při pagehide práci pozastavte a obnovte ji při pageshow s persisted === true: obnovený dokument si ponechá svůj DOM a událost DOMContentLoaded už znovu nenastane.
Důležitá data ukládejte průběžně. pagehide nemusí nastat, zvlášť při vynuceném ukončení mobilního prohlížeče, a asynchronní operace spuštěné v tomto okamžiku se nemusí dokončit. Na skrytí stránky reagujte pomocí visibilitychange na document a kontrolujte stav "hidden". Jde o API webové platformy, nikoli o novinky ECMAScriptu 2024.
Pří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ýsledek
DOM ready
Uložte příklad jako soubor HTML a otevřete jej v prohlížeči. V konzoli zapněte zachování výpisu a znovu načtěte stránku. `DOM ready` se objeví při vyvolání `DOMContentLoaded`. Další zprávy závisejí na navigaci a na tom, zda prohlížeč dokument zachová.
Související lekce
- JavaScript · Lekce 40 · Pokročilá · Verze: 4
- JavaScript · Lekce 41 · Pokročilá · Verze: 4