CKTIS / JavaScript
Einmalige Ereignis-Listener mit `once`
Mit `{ once: true }` wird die Rückruffunktion pro Registrierung höchstens einmal aufgerufen. Die Registrierung wird schon vor dem Aufruf entfernt.
Version: Current web platform; runtime support varies
Syntax
target.addEventListener(type, listener);
target.addEventListener(type, listener, { once: true });
target.addEventListener(type, listener, useCapture);Die Option once von EventTarget.addEventListener steht im Optionsobjekt, das als drittes Argument übergeben wird. Mit { once: true } wird die Rückruffunktion pro Registrierung höchstens einmal aufgerufen. Ohne once gilt false. Ein direkt als drittes Argument übergebenes true setzt capture, nicht once.
Die API entfernt die Registrierung unmittelbar vor dem Aufruf der Rückruffunktion. Ein verschachtelter Aufruf von dispatchEvent() mit einem neuen Ereignis desselben Typs kann die Funktion daher nicht über dieselbe Registrierung aufrufen. Eine ausgelöste Ausnahme stellt die Registrierung nicht wieder her. Erreicht kein Ereignis die Rückruffunktion, entfernt once die Registrierung nicht von allein.
Auf demselben Ziel ändert ein erneuter Aufruf von addEventListener() mit demselben Ereignistyp, derselben Rückruffunktion und demselben capture-Wert die bestehende Registrierung nicht, auch wenn once abweicht. Um die Einstellung zu ändern, entferne die Registrierung zuerst mit removeEventListener() und passendem Typ, passender Rückruffunktion und passendem capture-Wert. Registriere die Funktion danach erneut.
EventTarget ist eine DOM-API der Hostumgebung, kein Bestandteil von ECMAScript 2024. Prüfe, ob die vorgesehene Laufzeitumgebung die Option unterstützt.
Beispiele
{
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}`);
}Ergebnis
calls: 1
Der erste Aufruf von `dispatchEvent()` ruft die Rückruffunktion auf. Weder der verschachtelte noch der darauffolgende Aufruf führt sie erneut aus. Erwartete Ausgabe: `calls: 1`.
Zugehörige Lektionen
- JavaScript · Lektion 39 · Fortgeschritten · Version: 4