CKTIS / JavaScript
DOMContentLoaded, pagehide en pageshow: DOM-gereedheid en navigatie
Zie het verschil tussen een DOM dat klaar is, het verlaten van een document en het herstellen ervan. Leer wat `readyState` en `persisted` je in elk geval vertellen.
Versie: 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 is een browsergebeurtenis van het type Event waarnaar je luistert op document. Ze treedt op nadat de HTML is geparseerd en klassieke scripts met defer zijn uitgevoerd. Voordat de gebeurtenis optreedt, start de browser ook de evaluatie van modulescripts zonder async die door de HTML-parser zijn ingevoegd. De browser wacht niet op de voltooiing van bewerkingen waarop await op het hoogste niveau van die modules of hun afhankelijkheden wacht. De initialisatie van modules kan dus na de gebeurtenis nog niet zijn afgerond. Ze wacht niet op afbeeldingen, frames of async-scripts. Stylesheets kunnen haar indirect vertragen doordat ze uitgestelde scripts blokkeren. Dit is niet de load-gebeurtenis.
Als je code laat kan draaien en alleen het geparseerde DOM nodig heeft, controleer dan document.readyState. Is de waarde "loading", voeg dan een eenmalige listener voor DOMContentLoaded toe; initialiseer anders meteen. "interactive" betekent dat het parseren klaar is, niet dat DOMContentLoaded al is opgetreden of dat andere scripts klaar zijn met initialiseren.
Luister op window naar pagehide bij het verlaten van een document en naar pageshow bij het laden of herstellen ervan. Beide zijn van het type PageTransitionEvent en hebben een booleaanse eigenschap persisted. Bij pagehide betekent true dat het document mogelijk wordt hergebruikt, zonder garantie; bij false wordt het niet hergebruikt. Bij een nieuwe lading volgt pageshow op load met false. Bij herstel uit de terug-/vooruitcache (bfcache) is de waarde true: hetzelfde DOM en dezelfde JavaScript-toestand keren terug zonder een nieuwe DOMContentLoaded.
Gebruik pagehide om paginagebonden taken te pauzeren en pageshow met persisted === true om ze te hervatten of verouderde gegevens te vernieuwen. pagehide kan uitblijven, bijvoorbeeld als een mobiele browser op de achtergrond wordt afgesloten. Sla belangrijke wijzigingen tussentijds op; gebruik visibilitychange en document.visibilityState om zichtbaarheid te volgen. Deze gebeurtenissen melden geen gewone tabwissel en horen bij het webplatform, niet bij ECMAScript.
Voorbeelden
(() => {
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"));
}
})();Resultaat
DOM ready
Plak de code één keer in de browserconsole nadat de pagina volledig is geladen. `DOM ready` komt dan door de controle van `readyState`, niet door een herhaalde gebeurtenis. Laat het consolelogboek behouden, open een ander document in hetzelfde tabblad en ga terug. Extra regels hangen af van de navigatie en van het gebruik van de bfcache.
Gerelateerde lessen
- JavaScript · Les 37 · Gevorderd · Versie: 4