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

CKTIS / JavaScript

EventTarget — recevoir et déclencher des événements

EventTarget est une interface de l’API Web qui permet d’enregistrer des écouteurs et de déclencher des événements. Une instance autonome peut être créée sans élément DOM.

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

const target = new EventTarget();
target.addEventListener(type, callback, options);
target.removeEventListener(type, callback, options);
const notCanceled = target.dispatchEvent(event);

EventTarget est une interface de l’API Web, et non une partie de la norme ECMAScript. new EventTarget() crée une cible d’événement autonome, sans parent dans l’arbre de propagation.

addEventListener() enregistre un écouteur. removeEventListener() exige le même type d’événement, la même référence de fonction de rappel et une valeur capture correspondante. Avec once: true, l’enregistrement de l’écouteur est automatiquement supprimé avant l’appel de sa fonction de rappel. Si cette fonction déclenche un nouvel événement du même type sur la même cible, l’enregistrement supprimé ne provoque pas de nouvel appel.

dispatchEvent() invoque les écouteurs de façon synchrone. La méthode renvoie false si l’indicateur d’annulation de l’événement est activé ; sinon, elle renvoie true. Pour un événement annulable, un appel à preventDefault() ou l’affectation event.returnValue = false, conservée par souci de compatibilité, peuvent activer cet indicateur. Le résultat n’indique pas si un écouteur existe. L’exemple nécessite un environnement qui fournit EventTarget et Event, mais pas nécessairement un navigateur. Il s’exécute sans modification dans Node.js 24, ce qui ne prouve pas sa compatibilité avec les navigateurs.

Exemples

const target = new EventTarget();
const log = [];

function onPing(event) {
  log.push(event.type);
  event.preventDefault();
}

target.addEventListener('ping', onPing, { once: true });
const first = target.dispatchEvent(new Event('ping', { cancelable: true }));
const second = target.dispatchEvent(new Event('ping', { cancelable: true }));

console.log(log.join(','));
console.log(first);
console.log(second);

Résultat

ping
false
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