Event()

Baseline Widely available

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

El constructor Event() crea un nuevo objeto Event. Un evento creado de esta manera se denomina evento sintético, a diferencia de un evento activado por el navegador, y se puede enviar mediante una secuencia de comandos.

Sintaxis

js
new Event(type)
new Event(type, options)

Valores

type

Un texto con el nombre del evento.

options Opcional

Un objeto con las siguientes propiedades:

bubbles Opcional

Un valor booleano que indica si el evento se propaga. Por defecto es false.

cancelable Opcional

Un valor booleano que indica si el evento puede ser cancelado. Por defecto es false.

composed Opcional

Un valor booleano que indica si el evento disparará listeners fuera de un shadow root (Para mas detalles ver Event.composed). Por defecto es false.

Valor de retorno

Una instancia del objeto Event.

Ejemplo

js
// crea un evento look que se propaga y no puede cancelarse

var evento = new Event("look", { bubbles: true, cancelable: false });
document.dispatchEvent(evento);

// El evento puede ser despachado desde cualquier elemento, no solo desde el `document`.
myDiv.dispatchEvent(evento);

Especificaciones

Specification
DOM Standard
# ref-for-dom-event-event

Compatibilidad con navegadores

BCD tables only load in the browser

Véase también