The dispatchEvent()
method of the EventTarget
sends an Event
to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent()
.
Calling dispatchEvent()
is the last step to firing an event. The event should have already been created and initialized using an Event()
constructor.
Note: When calling this method, the Event.target
property is initialized to the current EventTarget
.
Unlike "native" events, which are fired by the browser and invoke event handlers asynchronously via the event loop, dispatchEvent()
invokes event handlers synchronously. All applicable event handlers are called and return before dispatchEvent()
returns.