eventPhase

Summary

Gets the event phase that is being evaluated.

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

Attributions

Microsoft Developer Network: [Windows Internet Explorer API reference Article]