Event.bubbles

Jump to:
  1. Syntax
  2. Example
  3. Specifications
  4. Browser compatibility
  5. See also

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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome Full support YesEdge ? Firefox ? IE ? Opera Full support YesSafari ? WebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android ? Opera Android Full support YesSafari iOS ? Samsung Internet Android ?

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

See also

  • stopPropagation() to stop bubbling the event
  • 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

Document Tags and Contributors

Tags: 
Contributors to this page: mfluehr, fscholz, Sheppy, chrisdavidmills, davidjudilla, Biiinggg, trrapp12, jpaugh, DomenicDenicola, cvrebert, teoli, kosvrouvas, kscarfone, Cobra, ziyunfei, Matej Lednar, Brettz9, Mgjbot, Jabez, Ptak82, Dria, JesseW
Last updated by: mfluehr,