CKTIS / JavaScript
DOMContentLoaded i opcija once za slušatelja
Upotrijebi `DOMContentLoaded` da pričekaš raščlambu HTML-a, a `{ once: true }` da jednu registraciju slušatelja ograničiš na najviše jedan poziv. Ako se kod može pokrenuti kasno, provjeri `document.readyState`.
Verzija: HTML Living Standard and DOM Standard; runtime support varies
Sintaksa
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();
}Preglednik pokreće DOMContentLoaded na document nakon što raščlani HTML i izvrši skripte predviđene za izvođenje nakon raščlambe: skripte s defer i module bez async. Ne čeka rad koji se nastavlja nakon await na najvišoj razini modula. Za razliku od load, događaj ne čeka slike, ugniježđene okvire ni skripte async. Stilske tablice mogu ga neizravno odgoditi ako blokiraju skripte koje događaj čeka.
U pozivu document.addEventListener("DOMContentLoaded", init, { once: true }) opcija once automatski uklanja tu registraciju prije nego što događaj prvi put pozove init. Zadana vrijednost je false. Samo true kao treći argument uključuje capture, ne once. Opcija ne ponavlja prošli događaj i ne ograničava ručne pozive ni kasnije registracije.
Ako init treba samo DOM izgrađen iz HTML-a, provjeri document.readyState: za "loading" registriraj slušatelja, a inače odmah pozovi init(). Preglednik ne može pokrenuti događaj između te sinkrone provjere i registracije. "interactive" znači da je raščlamba završila, a ne da se DOMContentLoaded već dogodio. Ako inicijalizacija ovisi o drugoj skripti, izričito je uskladi s tom skriptom.
Događaj, svojstvo stanja i opcija slušatelja dio su web API-ja, a ne ECMAScripta. Podrška za ECMAScript 2024 ne jamči njihovu dostupnost u određenom izvršnom okruženju.
Primjeri
(() => {
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}`);
})();Rezultat
After first dispatch: 1 After second dispatch: 1
Pokreni kod u konzoli preglednika. Dva sintetička događaja istog naziva šalju se zasebnom objektu `EventTarget`, a ne objektu `document`. Pokazuju učinak opcije `once`, a ne kada je stranica spremna.
Povezane lekcije
- JavaScript · Lekcija 39 · Srednje · Verzija: 3