Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Jednokratni slušači događaja s opcijom `once`

Uz `{ once: true }` funkcija za obradu događaja poziva se najviše jednom po registraciji. Registracija se uklanja prije poziva funkcije.

Verzija: Current web platform; runtime support varies

Sintaksa

target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);

Opcija once metode EventTarget.addEventListener nalazi se u objektu s opcijama koji se prosljeđuje kao treći argument. Uz { once: true } funkcija za obradu događaja može se pozvati najviše jednom u okviru te registracije. Ako izostaviš once, vrijedi false. Samo true kao treći argument postavlja capture, a ne once.

API uklanja registraciju neposredno prije poziva funkcije. Ugniježđeni poziv dispatchEvent() s novim događajem iste vrste zato ne može pozvati funkciju preko iste registracije. Ako funkcija baci iznimku, registracija se ne obnavlja. Ako nijedan događaj ne dođe do funkcije, once sam po sebi neće ukloniti registraciju.

Na istom cilju ponovni poziv addEventListener() s istom vrstom događaja, istom funkcijom i istom vrijednošću capture neće promijeniti postojeću registraciju, čak ni uz drukčiju vrijednost once. Za promjenu opcije prvo pozovi removeEventListener() s odgovarajućom vrstom događaja, funkcijom i vrijednošću capture, a zatim ponovno registriraj funkciju.

EventTarget je sučelje DOM-a koje pruža okruženje domaćina i nije dio ECMAScripta 2024. Provjeri podržava li ciljno izvršno okruženje tu opciju.

Primjeri

{
  const target = new EventTarget();
  let calls = 0;

  target.addEventListener("ready", () => {
    calls += 1;
    if (calls === 1) target.dispatchEvent(new Event("ready"));
  }, { once: true });

  target.dispatchEvent(new Event("ready"));
  target.dispatchEvent(new Event("ready"));
  console.log(`calls: ${calls}`);
}

Rezultat

calls: 1

Prvi poziv `dispatchEvent()` pokreće funkciju za obradu događaja. Ni ugniježđeni ni sljedeći poziv ne pokreću je ponovno. Očekivani ispis: `calls: 1`.

Povezane lekcije

  • JavaScript · Lekcija 39 · Napredno · Verzija: 4

Izvori