CKTIS / JavaScript
DOMContentLoaded a volba once pro posluchače
Pomocí `DOMContentLoaded` počkej na zpracování HTML a pomocí `{ once: true }` omez jednu registraci posluchače na nejvýše jedno volání. Pokud může kód začít později, zkontroluj `document.readyState`.
Verze: HTML Living Standard and DOM Standard; runtime support varies
Syntaxe
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();
}Prohlížeč vyvolá DOMContentLoaded na document po zpracování HTML a spuštění skriptů naplánovaných až po něm: skriptů s defer a modulů bez async. Nečeká na práci, která pokračuje po await na nejvyšší úrovni modulu. Na rozdíl od load událost nečeká na obrázky, vnořené rámce ani skripty async. Styly ji mohou nepřímo zpozdit, pokud blokují skripty, na které událost čeká.
Ve volání document.addEventListener("DOMContentLoaded", init, { once: true }) volba once automaticky odstraní tuto registraci ještě před prvním vyvoláním funkce init událostí. Výchozí hodnota je false. Samotné true jako třetí argument zapíná capture, nikoli once. Volba neopakuje dřívější událost ani neomezuje ruční volání nebo pozdější registrace.
Pokud init potřebuje jen DOM vytvořený z HTML, zkontroluj document.readyState: při "loading" zaregistruj posluchače, jinak rovnou zavolej init(). Prohlížeč nemůže vyvolat událost mezi touto synchronní kontrolou a registrací. "interactive" znamená, že zpracování HTML skončilo, ne že už nastala událost DOMContentLoaded. Pokud inicializace závisí na jiném skriptu, výslovně ji s ním synchronizuj.
Událost, vlastnost se stavem dokumentu a volba posluchače patří mezi webová API, nikoli do ECMAScriptu. Podpora ECMAScriptu 2024 nezaručuje jejich dostupnost v daném běhovém prostředí.
Pří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ýsledek
After first dispatch: 1 After second dispatch: 1
Spusť kód v konzoli prohlížeče. Dvě syntetické události stejného názvu se vyvolají na samostatném `EventTarget`, ne na `document`. Ukazují chování `once`, nikoli to, kdy je stránka připravená.
Související lekce
- JavaScript · Lekce 39 · Středně pokročilá · Verze: 3