Event: Event() constructor
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.
Note: This feature is available in Web Workers.
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
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
// 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 # ref-for-dom-event-event |
Browser compatibility
Loading…