CKTIS / JavaScript
EventTarget.removeEventListener — remover ouvintes de eventos
removeEventListener() remove um ouvinte ao comparar o tipo de evento, a identidade do callback e o valor de capture no mesmo destino.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
target.removeEventListener(type, callback[, options])EventTarget.removeEventListener remove um ouvinte registado através de addEventListener(). Devolve undefined; se não houver correspondência, nada é alterado.
O destino, type, a identidade de callback e capture têm de corresponder. Guarde a referência da função: uma função nova com código idêntico não corresponde. Isto também se aplica a objetos com handleEvent().
options aceita um valor booleano ou um objeto que contenha capture; o valor predefinido é false. passive, once e signal não são considerados na correspondência. Os registos com capture: true e capture: false têm de ser removidos separadamente.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.