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.
optionsOptional-
An object with the following properties:
bubblesOptional-
A boolean value indicating whether the event bubbles. The default is
false. cancelableOptional-
A boolean value indicating whether the event can be cancelled. The default is
false. composedOptional-
A boolean value indicating whether the event will trigger listeners outside of a shadow root (see
Event.composedfor more details). The default isfalse.
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