CKTIS / JavaScript
Enkratni poslušalci dogodkov z možnostjo `once`
Z `{ once: true }` se povratna funkcija pokliče največ enkrat na registracijo. Registracija se odstrani, še preden se funkcija pokliče.
Različica: Current web platform; runtime support varies
Sintaksa
target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);Možnost once metode EventTarget.addEventListener je lastnost objekta z možnostmi, ki ga podate kot tretji argument. Z { once: true } se povratna funkcija za to registracijo pokliče največ enkrat. Če once izpustite, velja false. Če kot tretji argument podate samo true, nastavite capture, ne once.
API odstrani registracijo tik pred klicem povratne funkcije. Zato ugnezdeni klic dispatchEvent() z novim dogodkom iste vrste funkcije ne more poklicati prek iste registracije. Če funkcija sproži izjemo, se registracija ne obnovi. Če povratne funkcije ne doseže noben dogodek, once sam po sebi ne odstrani registracije.
Ponovni klic addEventListener() na istem cilju z isto vrsto dogodka, isto povratno funkcijo in isto vrednostjo capture ne spremeni obstoječe registracije, tudi če je once drugačen. Nastavitev spremenite tako, da najprej pokličete removeEventListener() z ustrezno vrsto dogodka, funkcijo in vrednostjo capture, nato pa funkcijo znova registrirate.
EventTarget je vmesnik DOM, ki ga zagotavlja gostiteljsko okolje, in ni del ECMAScripta 2024. Preverite, ali ciljno izvajalno okolje podpira to možnost.
Primeri
{
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 klic `dispatchEvent()` pokliče povratno funkcijo. Niti ugnezdeni niti poznejši klic je ne pokliče znova. Pričakovani izpis: `calls: 1`.
Povezane lekcije
- JavaScript · Lekcija 39 · Napredna · Različica: 4