CKTIS / JavaScript
EventTarget.dispatchEvent(): despacho síncrono de eventos
dispatchEvent(event) despacha um evento para um alvo de forma síncrona. O resultado booleano indica se o evento foi cancelado, não se existem listeners.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
target.dispatchEvent(event)target.dispatchEvent(event) despacha um objeto Event para um EventTarget. Os listeners são chamados de forma síncrona; o método não aguarda pela conclusão do trabalho assíncrono iniciado pelos listeners. O evento tem isTrusted === false.
O resultado é false quando o evento é cancelado; caso contrário, é true. preventDefault() só cancela o evento com cancelable: true e fora de um listener passivo. stopPropagation() não significa que o evento foi cancelado.
Numa árvore DOM, aplicam-se a captura e o bubbling opcional (bubbles). Um new EventTarget() autónomo não tem pai. As exceções dos listeners são comunicadas, mas não se propagam até ao autor da chamada. Voltar a despachar o objeto que está a ser despachado provoca InvalidStateError.
O exemplo demonstra a ordem síncrona e o cancelamento. O código da aplicação pode usar o resultado para não efetuar a gravação.
Exemplos
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(" | "));Resultado
before | listener | after: false
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.