CKTIS / JavaScript
De gebeurtenissen DOMContentLoaded en pagehide
Gebruik `DOMContentLoaded` om code te initialiseren zodra het DOM is opgebouwd en `pagehide` om werk te pauzeren bij het verlaten van het document. Herstel uit de bfcache is geen nieuwe laadbeurt.
Versie: 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 is een Event op document. Het wordt afgevuurd nadat de browser de HTML heeft geparseerd, de klassieke scripts met defer heeft uitgevoerd en de evaluatie van de voor het einde van het parsen geplande modulescripts zonder async in gang heeft gezet. De gebeurtenis wacht niet tot de module-evaluatie is voltooid: als de uitvoering van een afhankelijkheid pauzeert bij een await op het hoogste niveau, kan de gebeurtenis al worden afgevuurd voordat de code van de importerende module begint te draaien. Het wacht niet op afbeeldingen, frames of de voltooiing van async-scripts. Stylesheets kunnen de gebeurtenis indirect vertragen door scriptuitvoering te blokkeren. Gebruik load op window als je moet wachten op bronnen die het laden van de pagina vertragen.
Kan de initialisatiecode laat starten, controleer dan document.readyState: registreer bij "loading" een eenmalige listener voor DOMContentLoaded en gebruik anders het al beschikbare DOM. Bij "interactive" is het parsen klaar, maar is de gebeurtenis niet per se al afgevuurd en zijn andere scripts niet per se klaar met hun initialisatie. Leg de initialisatievolgorde expliciet vast als je van die scripts afhankelijk bent.
Luister op window naar pagehide om te reageren wanneer de browser het document verlaat, bijvoorbeeld bij terugnavigeren. Dit PageTransitionEvent meldt geen gewone tabbladwissel en kan de navigatie niet annuleren. event.persisted === true betekent dat het document bewaard kan blijven in de cache voor terug- en vooruitnavigatie (bfcache), niet dat herstel gegarandeerd is. false betekent dat het document voor die navigatie niet wordt bewaard. Pauzeer werk bij pagehide en hervat het bij pageshow met persisted === true: een hersteld document behoudt zijn DOM en vuurt DOMContentLoaded niet opnieuw af.
Sla belangrijke gegevens tussentijds op. pagehide kan uitblijven, vooral als een mobiele browser geforceerd wordt afgesloten, en asynchroon werk dat daar begint kan onafgemaakt blijven. Luister naar visibilitychange op document en controleer op "hidden" om te reageren wanneer de pagina onzichtbaar wordt. Dit zijn API’s van het webplatform, geen functies die in ECMAScript 2024 zijn toegevoegd.
Voorbeelden
<!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>Resultaat
DOM ready
Sla het voorbeeld op als HTML-bestand en open het in een browser. Schakel in de console de optie in om het logboek te bewaren en herlaad de pagina. `DOM ready` verschijnt wanneer `DOMContentLoaded` wordt afgevuurd. De volgende meldingen hangen af van de navigatie en van de vraag of de browser het document bewaart.
Gerelateerde lessen
- JavaScript · Les 40 · Gevorderd · Versie: 4
- JavaScript · Les 41 · Gevorderd · Versie: 4