WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen