Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti