element.dispatchEvent

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Resumen

Lanza un evento en el sistema de eventos. El evento está sujeto al mismo comportamiento y capacidades que si fuera un evento de lanzamiento directo.

Sintaxis

bool = element.dispatchEvent(event)
  • element es el objetivo (target en Inglés) del evento.
  • event es un objeto de tipo event que será lanzado.
  • El valor devuelto es false, si al menos uno de los negociadores (en Inglés:handler ) que manejan el evento es preventDefault. En caso contrario, devuelve true.

Notas

Como se ve en el ejemplo anterior, dispatchEvent es el último paso en el proceso crear-inicializar-lanzar, que se usa para el lanzamiento manual de eventos en el modelo de implementación de eventos.

El evento puede ser creado mediante el método document.createEvent e inicializado usando initEvent u otro método, más específicamente, métodos de inicialización como initMouseEvent o initUIEvent.

Ver también Event object reference.

Especificación

DOM Level 2 Events: dispatchEvent