document.createEvent

Creates an event of the type specified. The returned object should be first initialized and can then be passed to element.dispatchEvent.

Syntax

var event = document.createEvent(type);

• event is the created Event object.
• type is a string that represents the type of event to be created. Possible event types include "UIEvents", "MouseEvents", "MutationEvents", and "HTMLEvents". See Notes section for details.

Example

// Create the event.
var event = document.createEvent('Event');

// Define that the event name is 'build'.
event.initEvent('build', true, true);

// Listen for the event.
elem.addEventListener('build', function (e) {
  // e.target matches elem
}, false);

// 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.

Gecko supports some non-standard event object aliases, which are listed below.

Specification

• DOM Level 2 Events: createEvent
• DOM Level 3 Events: createEvent

See also

• Creating and triggering events