Document: createEvent() method
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
Warning:
Many methods used with createEvent, such as initCustomEvent, are deprecated.
Use event constructors instead.
Creates an event of the type specified. The
returned object should be first initialized and can then be passed to
EventTarget.dispatchEvent.
Syntax
createEvent(type)
Parameters
Return value
An Event object.
Examples
// Create the event.
const event = document.createEvent("Event");
// Define that the event name is 'build'.
event.initEvent("build", true, true);
// Listen for the event.
elem.addEventListener("build", (e) => {
// e.target matches elem
});
// Target can be any Element or other EventTarget.
elem.dispatchEvent(event);
Notes
Event type strings suitable for passing to createEvent() are listed in the
DOM standard — see the table in step 2. Bear in mind that most event objects now have constructors, which
are the modern recommended way to create event object instances.
Specifications
| Specification |
|---|
| DOM # dom-document-createevent |
Browser compatibility
| desktop | mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
createEvent
|
|
|
|
|
|
|
|
|
|
|
|
|
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Deprecated. Not for use in new websites.
- See implementation notes.