Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

EventTarget.dispatchEvent(): invio sincrono degli eventi

dispatchEvent(event) invia un evento a un target in modo sincrono. Il risultato booleano indica se l’evento è stato annullato, non se sono presenti listener.

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

target.dispatchEvent(event)

target.dispatchEvent(event) invia un oggetto Event a un EventTarget. I listener vengono eseguiti in modo sincrono; il metodo non attende il completamento delle operazioni asincrone avviate dai listener. L’evento ha isTrusted === false.

Il risultato è false se l’evento viene annullato, altrimenti è true. preventDefault() annulla l’evento solo con cancelable: true e al di fuori di un listener passivo. stopPropagation() non significa che l’evento sia stato annullato.

In un albero DOM si applicano la fase di cattura e l’eventuale bubbling (bubbles). Un new EventTarget() autonomo non ha un genitore. Le eccezioni dei listener vengono segnalate, ma non si propagano al chiamante. Inviare di nuovo l’oggetto mentre è in fase di invio causa InvalidStateError.

L’esempio mostra l’ordine sincrono e l’annullamento. Il codice dell’applicazione può usare il risultato per saltare il salvataggio.

Esempi

const target = new EventTarget();
const log = [];

target.addEventListener("save", (event) => {
  log.push("listener");
  event.preventDefault();
});

log.push("before");
const accepted = target.dispatchEvent(
  new Event("save", { cancelable: true })
);
log.push(`after: ${accepted}`);
console.log(log.join(" | "));

Risultato

before | listener | after: false

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