Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes