This page is Almost Ready

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

eventPhase

Summary

Gets the event phase that is being evaluated.

Property of dom/Eventdom/Event

Syntax

Note: This property is read-only.

var eventPhase = event.eventPhase;

Return Value

Returns an object of type NumberNumber

0 is the initial and final phase (NONE), which means an event has not been dispatched, or the event is done dispatching. 1 is the capturing phase (CAPTURING_PHASE), which means it is currently running the capturing event handlers. 2 is the at target phase (AT_TARGET), which means it is currently running the event handlers that were added to the same element the event on which was dispatched. 3 is the bubbling phase (BUBBLING_PHASE), which means it is currently running event handlers of parent nodes of the original target element.

Notes

During the capturing phase, events are dispatched to parent elements before objects that are lower in the hierarchy. Next, during the bubbling phase, events are dispatched to target elements followed by parent objects. The event phase is AT_TARGET when the element that receives the event (target) is the same element as the element that is processing the event (currentTarget). The target element receives both capture and bubble events if both are registered.

Related specifications

DOM Level 3 Events
Working Draft

See also

Related pages

Attributions