CKTIS / JavaScript
EventTarget.removeEventListener — supprimer des écouteurs d’événements
removeEventListener() supprime un écouteur en faisant correspondre le type d’événement, l’identité du callback et la valeur de capture sur la même cible.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
target.removeEventListener(type, callback[, options])EventTarget.removeEventListener supprime un écouteur enregistré avec addEventListener(). La méthode renvoie undefined ; en l’absence de correspondance, rien ne change.
La cible, type, l’identité du callback et capture doivent correspondre. Conservez la référence de la fonction : une nouvelle fonction au code identique ne correspond pas. Cela s’applique aussi aux objets dotés de handleEvent().
options accepte une valeur booléenne ou un objet contenant capture ; la valeur par défaut est false. passive, once et signal ne sont pas pris en compte pour la correspondance. Les enregistrements avec capture: true et capture: false doivent être supprimés séparément.
Exemples
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);Résultat
1 1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.