Event.bubbles

The bubbles read-only property of the Event interface indicates whether the event bubbles up through the DOM or not.

Note: See Event bubbling and capture for more information on bubbling.

Syntax

var doesItBubble = event.bubbles;

Value

A Boolean, which is true if the event bubbles up through the DOM.

Example

function handleInput(e) {
  // Checks whether the event bubbles and ...
  if (!e.bubbles) {
    // ... passes the event along if does not
    passItOn(e);
  }

  // Already bubbling
  doOutput(e);
}

Note: Only certain events can bubble. Events that do bubble have this property set to true. You can use this property to check if an event is allowed to bubble or not.

Specifications

Specification Status Comment
DOM
The definition of 'Event.bubbles' in that specification.		 Living Standard
Document Object Model (DOM) Level 2 Events Specification
The definition of 'Event.bubbles' in that specification.		 Obsolete Initial definition.

Browser compatibility

BCD tables only load in the browser

See also

  • stopPropagation() to prevent further propagation of the current event in the capturing and bubbling phases
  • stopImmediatePropagation() to not call any further listeners for the same event at the same level in the DOM
  • preventDefault() to allow propagation to continue but to disallow the browser to perform its default action should no listeners handle the event