Web/API/Event/bubbles

From Get docs
< Web/API‎ | Event


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

Note: See [[../../../../Learn/JavaScript/Building_blocks/Events#Event_bubbling_and_capture|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
DOMThe definition of 'Event.bubbles' in that specification. Living Standard
Document Object Model (DOM) Level 2 Events SpecificationThe definition of 'Event.bubbles' in that specification. Obsolete Initial definition.

Browser compatibility

Update compatibility data on GitHub

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
bubbles Chrome

Full support Yes

Edge

Full support 12

Firefox

Full support Yes

IE

?

Opera

Full support Yes

Safari

Full support Yes

WebView Android

Full support Yes

Chrome Android

Full support Yes

Firefox Android

Full support Yes

Opera Android

Full support Yes

Safari iOS

Full support Yes

Samsung Internet Android

Full support Yes

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