Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes