CustomEvent: initCustomEvent() method

Deprecated

Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.

Note: This feature is available in Web Workers.

The CustomEvent.initCustomEvent() method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing.

Events initialized in this way must have been created with the Document.createEvent() method. This method must be called to set the event before it is dispatched using EventTarget.dispatchEvent(). Once dispatched, it doesn't do anything anymore.

Note: Do not use this method anymore, as it is deprecated.

Rather than using the feature, instead use specific event constructors, like CustomEvent(). The section on Creating and dispatching events gives more information about the way to use those.

Syntax

js
initCustomEvent(type, canBubble, cancelable, detail)

Parameters

type

A string containing the name of the event.

canBubble

A boolean value indicating whether the event bubbles up through the DOM or not.

cancelable

A boolean value indicating whether the event is cancelable.

detail

Any data that will be available to the handler through the CustomEvent.detail property.

Return value

None (undefined).

Specifications

Specification
DOM
# dom-customevent-initcustomevent

Browser compatibility

See also