CKTIS / JavaScript
DOMContentLoaded und die Listener-Option once
Warte mit `DOMContentLoaded`, bis das HTML geparst ist, und begrenze mit `{ once: true }` eine Listener-Registrierung auf höchstens einen Aufruf. Prüfe `document.readyState`, wenn dein Code erst später starten kann.
Version: HTML Living Standard and DOM Standard; runtime support varies
Syntax
document.addEventListener("DOMContentLoaded", init, { once: true });
// Instead, if init only needs the parsed DOM and may be set up late:
if (document.readyState === "loading") {
document.addEventListener("DOMContentLoaded", init, { once: true });
} else {
init();
}Der Browser löst DOMContentLoaded auf document aus, nachdem er das HTML geparst und die für danach vorgesehenen Skripte ausgeführt hat: defer-Skripte und Module ohne async. Er wartet nicht auf Arbeit, die nach einem await auf Modulebene fortgesetzt wird. Anders als load wartet das Ereignis weder auf Bilder und Unterframes noch auf async-Skripte. Stylesheets können es indirekt verzögern, wenn sie Skripte blockieren, auf die das Ereignis wartet.
Bei document.addEventListener("DOMContentLoaded", init, { once: true }) entfernt once diese Registrierung automatisch, bevor das Ereignis erstmals init aufruft. Der Standardwert ist false. Ein bloßes true als drittes Argument setzt capture, nicht once. Die Option holt kein früheres Ereignis nach und begrenzt weder manuelle Aufrufe noch spätere Registrierungen.
Wenn init nur das geparste DOM braucht, prüfe document.readyState: Bei "loading" registrierst du den Listener, sonst rufst du sofort init() auf. Zwischen dieser synchronen Prüfung und der Registrierung kann der Browser das Ereignis nicht auslösen. "interactive" heißt, dass das Parsen abgeschlossen ist, nicht dass DOMContentLoaded bereits ausgelöst wurde. Wenn die Initialisierung von einem anderen Skript abhängt, stimme sie ausdrücklich mit diesem Skript ab.
Das Ereignis, die Statuseigenschaft und die Listener-Option gehören zu den Web-APIs, nicht zu ECMAScript. Unterstützung für ECMAScript 2024 garantiert nicht, dass sie in einer bestimmten Laufzeitumgebung verfügbar sind.
Beispiele
(() => {
const target = new EventTarget();
let calls = 0;
target.addEventListener("DOMContentLoaded", () => {
calls += 1;
}, { once: true });
target.dispatchEvent(new Event("DOMContentLoaded"));
console.log(`After first dispatch: ${calls}`);
target.dispatchEvent(new Event("DOMContentLoaded"));
console.log(`After second dispatch: ${calls}`);
})();Ergebnis
After first dispatch: 1 After second dispatch: 1
Führe den Code in einer Browserkonsole aus. Zwei gleichnamige synthetische Ereignisse werden auf einem separaten `EventTarget` ausgelöst, nicht auf `document`. Sie zeigen die Wirkung von `once`, nicht den Zeitpunkt, zu dem die Seite bereit ist.
Zugehörige Lektionen
- JavaScript · Lektion 39 · Mittlere Stufe · Version: 3