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

CKTIS / JavaScript

CustomEvent.detail — données d’un événement personnalisé

CustomEvent.detail expose les données fournies lors de la création d’un événement. Sa valeur par défaut est null ; les objets sont transmis sans être clonés.

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 event = new CustomEvent(type, { detail: value });
event.detail

CustomEvent.detail est une propriété d’instance de CustomEvent qui contient les données définies via l’option detail du constructeur. Si l’option detail est omise ou explicitement définie à undefined, Web IDL applique la valeur par défaut null : event.detail === null.

La propriété est en lecture seule, mais elle ne fige pas l’objet stocké. L’objet n’est pas cloné : modifier event.detail.count modifie le même objet que celui transmis au constructeur.

Un écouteur lit les données via event.detail. L’exemple montre la référence partagée et la valeur par défaut null. Il s’agit d’une interface DOM, et non d’une fonctionnalité du langage ECMAScript ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge dans les navigateurs.

Exemples

const target = new EventTarget();
const payload = { count: 1 };

 target.addEventListener("count-change", (event) => {
  console.log(event.detail === payload);
  event.detail.count += 1;
});

target.dispatchEvent(new CustomEvent("count-change", { detail: payload }));
console.log(payload.count);
console.log(new CustomEvent("empty").detail);

Résultat

true
2
null

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