CKTIS / JavaScript
EventTarget.addEventListener — Ereignis-Listener registrieren
EventTarget.addEventListener registriert eine Ereignis-Callback-Funktion. Die Optionen capture, once und passive steuern, wann sie aufgerufen wird und ob sie das Ereignis abbrechen kann.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
target.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }EventTarget.addEventListener registriert einen callback für den Ereignistyp type. Das dritte Argument ist ein Optionsobjekt oder ein boolescher Wert für capture. Diese API gehört zum DOM-Standard, nicht zu ECMAScript selbst.
capture: true wählt bei Vorfahren die Erfassungsphase statt des Bubblings; beide Einstellungen ermöglichen einen Aufruf direkt am Ziel. capture und once sind standardmäßig false. Bei once: true wird die Registrierung entfernt, bevor callback aufgerufen wird. Löst callback während dieses Aufrufs ein Ereignis aus, kann dieses Ereignis callback nicht erneut über dieselbe Registrierung aufrufen. passive: true verhindert das Abbrechen mit preventDefault(), stoppt aber nicht die Weitergabe. Um ein abbrechbares Ereignis abzubrechen, setze ausdrücklich passive: false: Wird die Option weggelassen, bedeutet das nicht immer false.
Duplikate werden anhand von type, der Identität von callback und capture erkannt; eine erneute Registrierung aktualisiert die Optionen nicht. removeEventListener erfordert dieselben drei Werte. Das Beispiel verwendet ein eigenständiges Ziel und zeigt daher keine Weitergabe zwischen Elementen.
Beispiele
const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
calls++;
event.preventDefault();
}, { capture: false, once: true, passive: false });
const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);Ergebnis
1 true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.