CKTIS / JavaScript
CustomEvent — eventi con dati personalizzati
CustomEvent estende Event con detail, consentendo ai dati definiti dall’applicazione di raggiungere i listener dell’evento.
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
new CustomEvent(type, { detail: null, bubbles: false, cancelable: false, composed: false })CustomEvent è un’interfaccia della Web API definita dal DOM Standard, non da ECMAScript. Il suo costruttore accetta un nome di evento e impostazioni facoltative. L’opzione detail può trasmettere qualsiasi valore JavaScript tranne undefined. Se ometti questa opzione o passi esplicitamente undefined, Web IDL usa il valore predefinito null. Gli oggetti non vengono copiati.
Creare un evento non lo invia: chiama dispatchEvent() su un EventTarget. Registra i listener con addEventListener(). L’invio è sincrono. Le opzioni bubbles, cancelable e composed sono false per impostazione predefinita. Verifica la disponibilità dell’API nel browser di destinazione; la versione di Node del repository non la attesta.
Esempi
{
const target = new EventTarget();
target.addEventListener("score", (event) => {
console.log(`score=${event.detail}`);
});
target.dispatchEvent(new CustomEvent("score", { detail: 7 }));
console.log("done");
}Risultato
score=7 done
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.