CKTIS / JavaScript
CustomEvent.detail — dati degli eventi personalizzati
CustomEvent.detail espone i dati forniti quando viene creato un evento. Il valore predefinito è null; gli oggetti vengono passati senza essere clonati.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const event = new CustomEvent(type, { detail: value });
event.detailCustomEvent.detail è una proprietà di istanza di CustomEvent che contiene i dati impostati tramite l’opzione detail del costruttore. Se detail viene omessa o impostata esplicitamente a undefined, Web IDL applica il valore predefinito null, quindi event.detail === null.
La proprietà è di sola lettura, ma non rende immutabile l’oggetto memorizzato. L’oggetto non viene clonato: modificare event.detail.count modifica lo stesso oggetto passato al costruttore.
Un listener legge i dati tramite event.detail. L’esempio mostra il riferimento condiviso e il valore predefinito null. Questa è un’interfaccia DOM, non una funzionalità del linguaggio ECMAScript; la presenza di Node 24 in un repository non dimostra il supporto nei browser.
Esempi
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);Risultato
true 2 null
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.