CKTIS / JavaScript
DOMContentLoaded i opcja once nasłuchiwania zdarzeń
Użyj `DOMContentLoaded`, aby zaczekać na sparsowanie HTML, a `{ once: true }`, aby dana rejestracja wywołała funkcję najwyżej raz. Jeśli kod może zacząć działać późno, sprawdź `document.readyState`.
Wersja: HTML Living Standard and DOM Standard; runtime support varies
Składnia
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();
}Przeglądarka wywołuje DOMContentLoaded na document po zakończeniu parsowania HTML i po wykonaniu skryptów odroczonych przez defer oraz modułów bez async zaplanowanych do wykonania po parsowaniu. Nie czeka na dokończenie pracy wznowionej po await najwyższego poziomu. W odróżnieniu od load zdarzenie nie czeka na obrazy, podramki ani skrypty async. Arkusze stylów mogą je opóźnić pośrednio, jeśli blokują skrypty, na które zdarzenie czeka.
W wywołaniu document.addEventListener("DOMContentLoaded", init, { once: true }) opcja once powoduje automatyczne usunięcie tej rejestracji przed pierwszym wywołaniem init przez zdarzenie. Domyślnie ma wartość false. Argument true przekazany samodzielnie oznacza capture, nie once. Opcja nie odtwarza minionego zdarzenia ani nie ogranicza wywołań ręcznych czy późniejszych rejestracji.
Jeśli init potrzebuje tylko sparsowanego DOM, sprawdź document.readyState: przy "loading" zarejestruj nasłuch, w przeciwnym razie wywołaj init() od razu. Zdarzenie przeglądarki nie może wystąpić pomiędzy tym synchronicznym sprawdzeniem a rejestracją. Stan "interactive" oznacza koniec parsowania, a nie to, że DOMContentLoaded już wystąpiło. Jeśli inicjalizacja zależy od innego skryptu, jawnie zsynchronizuj się z tym skryptem.
Zdarzenie, stan dokumentu i opcja nasłuchu należą do API platformy webowej, a nie do ECMAScript. Zgodność z ECMAScript 2024 nie gwarantuje ich dostępności w danym środowisku.
Przykłady
(() => {
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}`);
})();Wynik
After first dispatch: 1 After second dispatch: 1
Uruchom kod w konsoli przeglądarki. Dwa syntetyczne zdarzenia o tej samej nazwie trafiają do osobnego `EventTarget`, nie do `document`. Pokazują działanie `once`, nie moment gotowości strony.
Powiązane lekcje
- JavaScript · Lekcja 39 · Średniozaawansowany · Wersja: 3