Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

DOMContentLoaded in možnost once za poslušalca

Z `DOMContentLoaded` počakaj na razčlenitev HTML-ja, z `{ once: true }` pa posamezno registracijo poslušalca omeji na največ en klic. Če se koda lahko zažene pozneje, preveri `document.readyState`.

Različica: 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();
}

Brskalnik sproži DOMContentLoaded na document, ko razčleni HTML in izvede skripte, predvidene za izvajanje po razčlenjevanju: skripte z defer in module brez async. Ne čaka na delo, ki se nadaljuje po await na vrhnji ravni modula. V nasprotju z load dogodek ne čaka na slike, vgnezdene okvirje ali skripte async. Slogovne predloge ga lahko posredno zakasnijo, če zadržijo skripte, na katere dogodek čaka.

V klicu document.addEventListener("DOMContentLoaded", init, { once: true }) možnost once samodejno odstrani to registracijo, preden dogodek prvič pokliče init. Privzeta vrednost je false. Samostojni true kot tretji argument vklopi capture, ne once. Možnost ne ponovi preteklega dogodka in ne omejuje ročnih klicev ali poznejših registracij.

Če init potrebuje le DOM, zgrajen iz HTML-ja, preveri document.readyState: pri "loading" registriraj poslušalca, sicer takoj pokliči init(). Brskalnik med tem sinhronim preverjanjem in registracijo ne more sprožiti dogodka. "interactive" pomeni, da je razčlenjevanje končano, ne pa, da se je DOMContentLoaded že sprožil. Če je inicializacija odvisna od druge skripte, jo izrecno uskladi z njo.

Dogodek, lastnost stanja in možnost poslušalca so del spletnih API-jev, ne ECMAScripta. Podpora za ECMAScript 2024 ne zagotavlja njihove razpoložljivosti v danem izvajalnem okolju.

Primeri

(() => {
  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

Zaženi kodo v konzoli brskalnika. Dva sintetična dogodka z istim imenom se sprožita na ločenem `EventTarget`, ne na `document`. Prikažeta delovanje `once`, ne trenutka, ko je stran pripravljena.

Povezane lekcije

  • JavaScript · Lekcija 39 · Srednja · Različica: 3

Viri