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

CKTIS / JavaScript

EventTarget.addEventListener — enregistrer des écouteurs d’événements

EventTarget.addEventListener enregistre une fonction de rappel pour un événement. Les options capture, once et passive contrôlent son invocation et la possibilité pour l’écouteur d’annuler l’événement.

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.addEventListener(type, callback, options);
// options: boolean capture, or { capture, once, passive, signal }

EventTarget.addEventListener enregistre un callback pour le type d’événement type. Le troisième argument est un objet d’options ou une valeur booléenne représentant capture. Cette API relève de la norme DOM, et non d’ECMAScript lui-même.

capture: true sélectionne la phase de capture plutôt que le bouillonnement sur les ancêtres ; les deux réglages permettent une invocation sur la cible elle-même. capture et once valent false par défaut. Avec once: true, l’enregistrement est supprimé avant l’appel de callback. Si callback déclenche un événement pendant cet appel, ce déclenchement imbriqué ne peut pas rappeler callback au titre du même enregistrement. passive: true empêche l’annulation via preventDefault(), mais n’arrête pas la propagation. Pour annuler un événement annulable, définissez explicitement passive: false : omettre cette option ne signifie pas toujours false.

Les doublons sont identifiés par type, l’identité de callback et capture ; un nouvel enregistrement ne met pas à jour les options. removeEventListener exige ces mêmes trois valeurs. L’exemple utilise une cible autonome et ne montre donc pas la propagation entre éléments.

Exemples

const target = new EventTarget();
let calls = 0;
target.addEventListener('demo', (event) => {
  calls++;
  event.preventDefault();
}, { capture: false, once: true, passive: false });

const first = new Event('demo', { cancelable: true });
target.dispatchEvent(first);
target.dispatchEvent(new Event('demo'));
console.log(calls, first.defaultPrevented);

Résultat

1 true

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