CKTIS / JavaScript
EventTarget.dispatchEvent(): despacho síncrono de eventos
dispatchEvent(event) despacha un evento a un destino de forma síncrona. Su resultado booleano indica si se canceló el evento, no si hay listeners.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
target.dispatchEvent(event)target.dispatchEvent(event) despacha un objeto Event a un EventTarget. Los listeners se ejecutan de forma síncrona; el método no espera a que termine el trabajo asíncrono que inicien los listeners. El evento tiene isTrusted === false.
El resultado es false si se cancela el evento y true en caso contrario. preventDefault() solo cancela el evento con cancelable: true y fuera de un listener pasivo. stopPropagation() no significa que el evento se haya cancelado.
En un árbol DOM se aplican la captura y el burbujeo opcional (bubbles). Un new EventTarget() independiente no tiene padre. Las excepciones de los listeners se notifican, pero no se propagan hasta quien hizo la llamada. Volver a despachar el objeto que se está despachando provoca InvalidStateError.
El ejemplo muestra el orden síncrono y la cancelación. El código de la aplicación puede usar el resultado para omitir el guardado.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.