CKTIS / JavaScript
EventTarget.removeEventListener — eliminar detectores de eventos
removeEventListener() elimina un detector al hacer coincidir el tipo de evento, la identidad del callback y el valor de capture en el mismo destino.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
target.removeEventListener(type, callback[, options])EventTarget.removeEventListener elimina un detector registrado mediante addEventListener(). Devuelve undefined; si no hay coincidencia, no se produce ningún cambio.
Deben coincidir el destino, type, la identidad de callback y capture. Conserva la referencia a la función: una función nueva con código idéntico no coincide. Esto también se aplica a los objetos con handleEvent().
options acepta un valor booleano o un objeto que contenga capture; el valor predeterminado es false. passive, once y signal no intervienen en la comparación. Los registros con capture: true y capture: false requieren eliminaciones por separado.
Ejemplos
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);Resultado
1 1
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.