Event: Event() constructor

The Event() constructor creates a new Event object. An event created in this way is called a synthetic event, as opposed to an event fired by the browser, and can be dispatched by a script.

Syntax

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

Values

type

A string with the name of the event.

options Optional

An object with the following properties:

bubbles Optional

A boolean value indicating whether the event bubbles. The default is false.

cancelable Optional

A boolean value indicating whether the event can be cancelled. The default is false.

composed Optional

A boolean value indicating whether the event will trigger listeners outside of a shadow root (see Event.composed for more details). The default is false.

Return value

A new Event object.

Example

js
// create a look event that bubbles up and cannot be canceled

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

// event can be dispatched from any element, not only the document
myDiv.dispatchEvent(evt);

Specifications

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

Browser compatibility

BCD tables only load in the browser

See also