CKTIS / JavaScript
DOMContentLoaded, pagehide und pageshow: DOM-Bereitschaft und Navigation
Unterscheide zwischen der Bereitschaft des DOM, dem Verlassen eines Dokuments und seiner Wiederherstellung. Erfahre, was `readyState` und `persisted` jeweils aussagen.
Version: 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 ist ein Browserereignis vom Typ Event, das du auf document abhörst. Es wird ausgelöst, nachdem das HTML geparst wurde und klassische Skripte mit defer ausgeführt wurden. Zuvor stößt der Browser auch die Auswertung der vom Parser eingefügten Modulskripte ohne async an. Das Ereignis wartet aber nicht auf den Abschluss eines await auf oberster Ebene in diesen Modulen oder ihren Abhängigkeiten. Die Modulinitialisierung kann deshalb nach dem Ereignis noch ausstehen. Es wartet nicht auf Bilder, Frames oder async-Skripte. Stylesheets können es indirekt verzögern, wenn sie verzögerte Skripte blockieren. Es ist nicht dasselbe wie load.
Wenn dein Code spät ausgeführt werden kann und nur das fertig geparste DOM braucht, prüfe document.readyState. Bei "loading" registrierst du einen einmaligen Listener für DOMContentLoaded; sonst initialisierst du sofort. "interactive" bedeutet, dass das Parsen abgeschlossen ist, nicht aber, dass DOMContentLoaded schon ausgelöst wurde oder andere Skripte ihre Initialisierung abgeschlossen haben.
Registriere auf window einen Listener für pagehide beim Verlassen und für pageshow beim Laden oder Wiederherstellen eines Dokuments. Beide Ereignisse haben den Typ PageTransitionEvent und die boolesche Eigenschaft persisted. Bei pagehide bedeutet true, dass das Dokument wiederverwendet werden kann, aber nicht zwingend wird; bei false wird es nicht wiederverwendet. Beim Neuladen eines Dokuments folgt pageshow auf load mit false. Bei der Wiederherstellung aus dem Zurück-/Vorwärts-Cache (bfcache) ist der Wert true: Dasselbe DOM und derselbe JavaScript-Zustand kehren ohne erneutes DOMContentLoaded zurück.
Pausiere seitenspezifische Aufgaben bei pagehide und setze sie bei pageshow mit persisted === true fort oder aktualisiere veraltete Daten. pagehide kann ausbleiben, etwa wenn ein mobiler Browser im Hintergrund beendet wird. Speichere wichtige Änderungen laufend; beobachte die Sichtbarkeit mit visibilitychange und document.visibilityState. Diese Ereignisse melden keinen gewöhnlichen Tabwechsel und gehören zur Webplattform, nicht zu ECMAScript.
Beispiele
(() => {
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"));
}
})();Ergebnis
DOM ready
Füge den Code nach dem vollständigen Laden einmal in die Browserkonsole ein. `DOM ready` stammt dann aus der Prüfung von `readyState`, nicht aus einem erneut ausgelösten Ereignis. Lass die Konsolenmeldungen erhalten, navigiere im selben Tab zu einem anderen Dokument und gehe zurück. Zusätzliche Meldungen hängen von der Navigation und der Nutzung des bfcache ab.
Zugehörige Lektionen
- JavaScript · Lektion 37 · Fortgeschritten · Version: 4