CKTIS / JavaScript
Die Ereignisse DOMContentLoaded, pagehide und resize
Wähle das passende Ereignis: `DOMContentLoaded` für den aufgebauten DOM, `pagehide` beim Verlassen der Seite und `resize` bei Größenänderungen des Ansichtsbereichs.
Version: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
document.addEventListener("DOMContentLoaded", onDomReady, { once: true });
window.addEventListener("pagehide", onPageHide);
window.addEventListener("resize", onResize);DOMContentLoaded, pagehide und resize gehören zur Webplattform, nicht zu ECMAScript 2024. Registriere die Listener mit addEventListener(): den ersten auf document, die anderen beiden auf window. Die Verfügbarkeit hängt von der Laufzeitumgebung ab; setze diese Browser-Ereignisziele weder in einem Worker noch in Node.js voraus.
DOMContentLoaded ist ein nicht abbrechbares Event, das von document aus aufsteigt. Der Browser löst es aus, nachdem er das HTML geparst, klassische Skripte mit defer ausgeführt und die Auswertung der für die Zeit nach dem Parsen vorgesehenen Modulskripte (ohne async) angestoßen hat. Er wartet nicht darauf, dass die asynchrone Modulauswertung abgeschlossen ist: Ein Modul kann noch an einem await auf oberster Ebene pausieren oder mit der Ausführung seines Codes noch auf eine asynchrone Abhängigkeit warten. Anders als load wartet es nicht direkt auf Bilder, Frames oder async-Skripte. Wenn du nur den geparsten DOM brauchst, registriere bei document.readyState === "loading" einen Listener mit { once: true }; sonst initialisiere sofort. "interactive" beweist weder, dass das Ereignis schon ausgelöst wurde, noch dass zurückgestellte Skripte den Zustand eingerichtet haben, den dein Code benötigt.
pagehide ist ein PageTransitionEvent, auf das du bei window hörst, wenn die Seite verlassen wird, nicht schon bei einem Tabwechsel. event.persisted === true bedeutet, dass die Seite im Vor-/Zurück-Cache (bfcache) gehalten werden kann; bei false wird dieses Dokument nicht auf diesem Weg wiederhergestellt. true garantiert keine Rückkehr: Eine tatsächliche Wiederherstellung erkennst du an pageshow mit persisted === true, ohne neues DOMContentLoaded. preventDefault() hält die Navigation nicht auf. pagehide kann ausbleiben, besonders auf Mobilgeräten. Speichere wichtige Daten deshalb früher; für den Wechsel in den Hintergrund nutze visibilitychange und prüfe document.visibilityState === "hidden".
Das resize-Ereignis auf window ist ein nicht abbrechbares Event, das nicht aufsteigt. Es meldet Größenänderungen des Ansichtsbereichs, nicht beliebiger Elemente. Lies die aktuellen Maße über window.innerWidth und window.innerHeight; für die Größe eines Elements nutze ResizeObserver. Änderungen können rasch aufeinanderfolgen, daher solltest du aufwendige Layoutberechnungen begrenzen.
Beispiele
(() => {
const documentTarget = globalThis.document ?? new EventTarget();
const windowTarget = globalThis.window ?? new EventTarget();
const controller = new AbortController();
const options = { signal: controller.signal };
documentTarget.addEventListener("DOMContentLoaded", (event) => {
console.log(event.type);
}, options);
windowTarget.addEventListener("pagehide", (event) => {
console.log(`${event.type}: persisted=${event.persisted}`);
}, options);
windowTarget.addEventListener("resize", (event) => {
console.log(event.type);
}, options);
try {
documentTarget.dispatchEvent(new Event("DOMContentLoaded", { bubbles: true }));
const pagehide = typeof PageTransitionEvent === "function"
? new PageTransitionEvent("pagehide", { persisted: true })
: Object.assign(new Event("pagehide"), { persisted: true });
windowTarget.dispatchEvent(pagehide);
windowTarget.dispatchEvent(new Event("resize"));
} finally {
controller.abort();
}
})();Ergebnis
DOMContentLoaded pagehide: persisted=true resize
Führe das Beispiel in der Browserkonsole eines neuen Tabs mit `about:blank` aus oder speichere den Code als `main.js` und starte ihn mit `node main.js` unter Node.js 24. In Node.js verwendet das Beispiel eigenständige `EventTarget`-Instanzen anstelle von `document` und `window`. Synthetische Ereignisse prüfen die Zuordnung der Listener; sie ändern weder den Bereitschaftszustand des Dokuments noch die Größe des Ansichtsbereichs, lösen keine Navigation aus und testen den bfcache nicht. `abort()` entfernt alle drei Listener.
Zugehörige Lektionen
- JavaScript · Lektion 34 · Fortgeschritten · Version: 4