Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources