Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes