CKTIS / JavaScript
DOMContentLoaded en de listeneroptie once
Wacht met `DOMContentLoaded` tot de HTML is geparseerd en beperk een listenerregistratie met `{ once: true }` tot één aanroep. Controleer `document.readyState` als je code pas later kan starten.
Versie: 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();
}De browser vuurt DOMContentLoaded af op document nadat de HTML is geparseerd en de daarvoor ingeplande scripts zijn uitgevoerd: scripts met defer en modules zonder async. De browser wacht niet op werk dat na een await op moduleniveau wordt hervat. Anders dan load wacht dit event niet op afbeeldingen, ingesloten frames of async-scripts. Stylesheets kunnen het event indirect vertragen als ze scripts blokkeren waarop het event wacht.
In document.addEventListener("DOMContentLoaded", init, { once: true }) verwijdert once die registratie automatisch voordat het event init voor het eerst aanroept. De standaardwaarde is false. Een losse true als derde argument schakelt capture in, niet once. De optie speelt geen eerder event opnieuw af en beperkt geen handmatige aanroepen of latere registraties.
Als init alleen de geparseerde DOM nodig heeft, controleer dan document.readyState: registreer de listener bij "loading" en roep anders meteen init() aan. De browser kan het event niet afvuren tussen deze synchrone controle en de registratie. "interactive" betekent dat het parsen klaar is, niet dat DOMContentLoaded al is afgevuurd. Als de initialisatie van een ander script afhangt, stem haar dan expliciet op dat script af.
Het event, de statuseigenschap en de listeneroptie horen bij de web-API’s, niet bij ECMAScript. Ondersteuning voor ECMAScript 2024 garandeert niet dat ze in een bepaalde uitvoeromgeving beschikbaar zijn.
Voorbeelden
(() => {
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}`);
})();Resultaat
After first dispatch: 1 After second dispatch: 1
Voer de code uit in de browserconsole. Twee synthetische events met dezelfde naam worden op een apart `EventTarget` afgevuurd, niet op `document`. Ze laten zien wat `once` doet, niet wanneer de pagina klaar is.
Gerelateerde lessen
- JavaScript · Les 39 · Gemiddeld · Versie: 3