CKTIS / JavaScript
DOMContentLoaded a voľba once pre poslucháča
Pomocou `DOMContentLoaded` počkaj na spracovanie HTML a pomocou `{ once: true }` obmedz jednu registráciu poslucháča na najviac jedno volanie. Ak sa kód môže spustiť neskôr, skontroluj `document.readyState`.
Verzia: 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();
}Prehliadač vyvolá DOMContentLoaded na document po spracovaní HTML a vykonaní skriptov naplánovaných až po ňom: skriptov s defer a modulov bez async. Nečaká na prácu, ktorá pokračuje po await na najvyššej úrovni modulu. Na rozdiel od load udalosť nečaká na obrázky, vnorené rámce ani skripty async. Štýly ju môžu nepriamo oneskoriť, ak blokujú skripty, na ktoré udalosť čaká.
Vo volaní document.addEventListener("DOMContentLoaded", init, { once: true }) voľba once automaticky odstráni túto registráciu ešte predtým, ako udalosť prvýkrát zavolá init. Predvolená hodnota je false. Samotné true ako tretí argument zapína capture, nie once. Voľba neopakuje minulú udalosť ani neobmedzuje ručné volania či neskoršie registrácie.
Ak init potrebuje iba DOM vytvorený z HTML, skontroluj document.readyState: pri "loading" zaregistruj poslucháča, inak ihneď zavolaj init(). Prehliadač nemôže vyvolať udalosť medzi touto synchrónnou kontrolou a registráciou. "interactive" znamená koniec spracovania HTML, nie to, že DOMContentLoaded už nastala. Ak inicializácia závisí od iného skriptu, výslovne ju s ním zosúlaď.
Udalosť, vlastnosť so stavom dokumentu a voľba poslucháča patria medzi webové API, nie do ECMAScriptu. Podpora ECMAScriptu 2024 nezaručuje ich dostupnosť v danom vykonávacom prostredí.
Príklady
(() => {
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}`);
})();Výsledok
After first dispatch: 1 After second dispatch: 1
Spusti kód v konzole prehliadača. Dve syntetické udalosti s rovnakým názvom sa vyvolajú na samostatnom `EventTarget`, nie na `document`. Ukazujú fungovanie `once`, nie čas pripravenosti stránky.
Súvisiace lekcie
- JavaScript · Lekcia 39 · Stredne pokročilá · Verzia: 3