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

CKTIS / JavaScript

Event.currentTarget — l’objet qui traite un événement

Event.currentTarget désigne l’objet dont le listener est en cours d’appel. Contrairement à event.target, il indique l’endroit où l’événement est traité, et non sa 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

event.currentTarget

Event.currentTarget est une propriété en lecture seule qui renvoie un EventTarget ou null. Lors de l’appel d’un listener, elle désigne l’objet sur lequel ce listener a été enregistré ; il ne s’agit pas nécessairement d’un élément.

event.target désigne la cible de l’événement, en tenant compte du réajustement de la cible par le Shadow DOM. event.currentTarget désigne l’endroit où l’événement est actuellement traité pendant les phases de capture et de propagation. Dans l’exemple, child est la cible, tandis que le listener s’exécute sur parent.

Avant le début de la distribution de l’événement et après sa fin, currentTarget vaut null. Si vous avez besoin de cet objet plus tard, par exemple après await, enregistrez-le pendant le traitement synchrone au lieu de lire la propriété ultérieurement à partir de l’événement conservé.

Exemples

const parent = document.createElement('div');
const child = document.createElement('button');
parent.append(child);

const event = new Event('demo', { bubbles: true });
let savedTarget;

parent.addEventListener('demo', (event) => {
  savedTarget = event.currentTarget;
  console.log(event.target === child);
  console.log(event.currentTarget === parent);
});

child.dispatchEvent(event);
console.log(event.currentTarget === null);
console.log(savedTarget === parent);

Résultat

true
true
true
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