Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes