Event: Event() constructor
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
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 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