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.