Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

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

Fonti