CKTIS / JavaScript
DOMContentLoaded, pagehide a pageshow: pripravenosť DOM a navigácia
Rozlíšte pripravenosť DOM, opustenie dokumentu a jeho obnovenie. Zistite, čo hodnoty `readyState` a `persisted` hovoria o stave DOM a opätovnom použití dokumentu.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
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 udalosť prehliadača typu Event, ktorú zachytávajte na document. Nastane po dokončení spracovania HTML a vykonaní klasických skriptov s defer. Pred vyvolaním udalosti prehliadač tiež začne vyhodnocovať modulové skripty bez async, ktoré vložil analyzátor HTML. Nečaká však na dokončenie operácií, na ktoré čaká await na najvyššej úrovni týchto modulov alebo ich závislostí. Inicializácia modulov teda nemusí byť dokončená ani po vyvolaní udalosti. Nečaká na obrázky, rámce ani skripty s async; štýly ju môžu nepriamo oneskoriť, ak blokujú odložené skripty. Nie je to udalosť load.
Ak sa kód môže spustiť neskoro a stačí mu DOM vytvorený pri spracovaní HTML, skontrolujte document.readyState. Pri hodnote "loading" pridajte jednorazový poslucháč udalosti DOMContentLoaded; inak inicializujte hneď. Hodnota "interactive" znamená, že spracovanie HTML skončilo, nie že už nastala udalosť DOMContentLoaded alebo že sa ostatné skripty stihli inicializovať.
Na window zachytávajte pagehide pri opustení dokumentu a pageshow pri jeho načítaní alebo obnovení. Obe udalosti sú typu PageTransitionEvent s logickou vlastnosťou persisted. Pri pagehide znamená true, že dokument možno znova použiť, nie že sa tak určite stane; false znamená, že sa znova nepoužije. Pri novom načítaní nasleduje pageshow po load s hodnotou false. Pri obnovení z vyrovnávacej pamäte pre navigáciu späť a vpred (bfcache) má hodnotu true: vráti sa ten istý DOM aj stav JavaScriptu bez ďalšej udalosti DOMContentLoaded.
Pri pagehide pozastavte úlohy stránky a pri pageshow s persisted === true ich obnovte alebo aktualizujte zastarané údaje. pagehide nemusí nastať, napríklad ak sa mobilný prehliadač ukončí na pozadí. Dôležité zmeny ukladajte priebežne; viditeľnosť sledujte pomocou visibilitychange a document.visibilityState. Tieto udalosti neoznamujú bežné prepnutie karty a patria do webovej platformy, nie do ECMAScriptu.
Prí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ýsledok
DOM ready
Po úplnom načítaní stránky vložte kód raz do konzoly prehliadača. Výpis `DOM ready` pochádza z kontroly `readyState`, nie z opakovanej udalosti. Zachovajte výpisy konzoly, prejdite na iný dokument na tej istej karte a vráťte sa späť. Ďalšie riadky závisia od navigácie a od toho, či prehliadač použije bfcache.
Súvisiace lekcie
- JavaScript · Lekcia 37 · Pokročilá · Verzia: 4