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.detailCustomEvent.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.