CKTIS / JavaScript
Eenmalige eventlisteners met `once`
Gebruik `{ once: true }` om een callback hoogstens één keer per registratie aan te roepen. De registratie wordt vóór de aanroep verwijderd.
Versie: Current web platform; runtime support varies
Syntax
target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);De optie once van EventTarget.addEventListener staat in het optieobject dat je als derde argument meegeeft. Met { once: true } kan die registratie de callback hoogstens één keer aanroepen. Laat je once weg, dan geldt false. Geef je rechtstreeks true mee als derde argument, dan stel je capture in, niet once.
De API verwijdert de registratie vlak voordat de callback wordt aangeroepen. Een geneste aanroep van dispatchEvent() met een nieuwe gebeurtenis van hetzelfde type kan de callback dus niet via diezelfde registratie aanroepen. Als de callback een uitzondering werpt, wordt de registratie niet hersteld. Als geen enkele gebeurtenis de callback bereikt, verwijdert once de registratie niet uit zichzelf.
Op hetzelfde doelobject laat een nieuwe aanroep van addEventListener() met hetzelfde gebeurtenistype, dezelfde callback en dezelfde capture-waarde de bestaande registratie intact, ook als once verschilt. Wil je die instelling wijzigen, gebruik dan eerst removeEventListener() met het bijbehorende type, de callback en de capture-waarde. Registreer de callback daarna opnieuw.
EventTarget is een DOM-API die de hostomgeving aanbiedt en maakt geen deel uit van ECMAScript 2024. Controleer of de beoogde uitvoeringsomgeving de optie ondersteunt.
Voorbeelden
{
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}`);
}Resultaat
calls: 1
De eerste aanroep van `dispatchEvent()` activeert de callback. De geneste aanroep en de daaropvolgende aanroep activeren de callback niet opnieuw. Verwachte uitvoer: `calls: 1`.
Gerelateerde lessen
- JavaScript · Les 39 · Gevorderd · Versie: 4