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