WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

EventTarget.removeEventListener — Ereignis-Listener entfernen

removeEventListener() entfernt einen Listener, indem Ereignistyp, Callback-Identität und capture-Wert am selben Zielobjekt abgeglichen werden.

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.removeEventListener(type, callback[, options])

EventTarget.removeEventListener entfernt einen Listener, der mit addEventListener() registriert wurde. Die Methode gibt undefined zurück; wenn keine Übereinstimmung gefunden wird, ändert sich nichts.

Zielobjekt, type, die Identität des callback und capture müssen übereinstimmen. Bewahre die Funktionsreferenz auf: Eine neue Funktion mit identischem Code stimmt nicht überein. Das gilt auch für Objekte mit handleEvent().

options akzeptiert einen booleschen Wert oder ein Objekt mit capture; standardmäßig ist der Wert false. passive, once und signal werden beim Abgleich nicht berücksichtigt. Registrierungen mit capture: true und capture: false müssen jeweils separat entfernt werden.

Beispiele

const target = new EventTarget();
let calls = 0;
function handler() {
  calls += 1;
}

target.addEventListener("ping", handler, true);
target.removeEventListener("ping", handler, false);
target.dispatchEvent(new Event("ping"));
console.log(calls);

target.removeEventListener("ping", handler, { capture: true });
target.dispatchEvent(new Event("ping"));
console.log(calls);

Ergebnis

1
1

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