CKTIS / JavaScript
DOMContentLoaded и опцията once за слушател
Използвай `DOMContentLoaded`, за да изчакаш разбора на HTML, и `{ once: true }`, за да ограничиш една регистрация на слушател до най-много едно извикване. Ако кодът може да стартира късно, провери `document.readyState`.
Версия: HTML Living Standard and DOM Standard; runtime support varies
Синтаксис
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();
}Браузърът задейства DOMContentLoaded върху document, след като приключи разбора на HTML и изпълни скриптовете, предвидени за изпълнение след разбора: скриптовете с defer и модулите без async. Той не изчаква работата, която продължава след await на най-горното ниво на модул. За разлика от load, събитието не изчаква изображения, вложени рамки или скриптове с async. Стиловите таблици могат косвено да го забавят, ако блокират скриптове, които събитието изчаква.
В document.addEventListener("DOMContentLoaded", init, { once: true }) опцията once автоматично премахва тази регистрация, преди събитието да извика init за първи път. Стойността по подразбиране е false. Самостоятелно true като трети аргумент включва capture, а не once. Опцията не повтаря минало събитие и не ограничава ръчните извиквания или по-късните регистрации.
Ако init се нуждае само от DOM, изграден от HTML, провери document.readyState: при "loading" регистрирай слушателя, а иначе извикай init() веднага. Браузърът не може да задейства събитието между тази синхронна проверка и регистрацията. "interactive" означава, че разборът е приключил, а не че DOMContentLoaded вече е настъпило. Ако инициализацията зависи от друг скрипт, синхронизирай я изрично с него.
Събитието, свойството за състояние и опцията на слушателя са част от уеб API, а не от ECMAScript. Поддръжката на ECMAScript 2024 не гарантира, че са налични в дадена среда за изпълнение.
Примери
(() => {
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}`);
})();Резултат
After first dispatch: 1 After second dispatch: 1
Изпълни кода в конзолата на браузъра. Две синтетични събития с едно и също име се изпращат към отделен `EventTarget`, а не към `document`. Те показват как действа `once`, а не кога страницата е готова.
Свързани уроци
- JavaScript · Урок 39 · Средно · Версия: 3