CKTIS / JavaScript
Jednorázový posluchač událostí s volbou `once`
Pomocí `{ once: true }` zajistíte, že se obslužná funkce zavolá nejvýše jednou na registraci. Registrace se odstraní ještě před voláním funkce.
Verze: Current web platform; runtime support varies
Syntaxe
target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);Volba once metody EventTarget.addEventListener patří do objektu voleb předávaného jako třetí argument. S { once: true } se obslužná funkce v rámci dané registrace zavolá nejvýše jednou. Bez uvedení once platí false. Samotné true jako třetí argument nastaví capture, nikoli once.
API odstraní registraci těsně před zavoláním obslužné funkce. Vnořené volání dispatchEvent() s novou událostí stejného typu proto nemůže funkci zavolat prostřednictvím téže registrace. Vyvolaná výjimka registraci neobnoví. Pokud se k funkci žádná událost nedostane, samotné once registraci neodstraní.
Opakované volání addEventListener() na stejném cíli se stejným typem události, stejnou funkcí a stejnou hodnotou capture existující registraci nezmění, ani když se liší hodnota once. Chcete-li nastavení změnit, nejprve zavolejte removeEventListener() s odpovídajícím typem, funkcí a hodnotou capture a potom funkci znovu zaregistrujte.
EventTarget je rozhraní DOM, které poskytuje hostitelské prostředí. Není součástí ECMAScriptu 2024. Ověřte si, zda cílové běhové prostředí tuto volbu podporuje.
Příklady
{
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}`);
}Výsledek
calls: 1
První volání `dispatchEvent()` spustí obslužnou funkci. Vnořené ani následující volání ji znovu nespustí. Očekávaný výstup: `calls: 1`.
Související lekce
- JavaScript · Lekce 39 · Pokročilá · Verze: 4