База знанияИзпитен център
BGБългарски
Избери език13

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

Източници