Skip to content

DOM events: stopPropagation vs preventDefault() vs. return false

Which one to use between `event.stopPropagation()`, `event.preventDefault()` and `return false` in events

I feel like I'm always confused by one thing when it comes to handling DOM events in JavaScript.

When should I call stopPropagation() on the event object? When should I call preventDefault() on the event object? Should I return false?

Event.stopPropagation

Suppose I want to handle a click event on an element.

By default an event on a DOM element is fired on the specific element clicked (say, a button) and will be propagated to all its parent elements tree, unless it’s stopped.

I want to make sure the event is handled in my event handler, and it will "stop" there.

You can stop the propagation by calling stopPropagation() method of an Event object, usually at the end of the event handler:

const link = document.getElementById('my-link')
link.addEventListener('mousedown', event => {
  // process the event
  // ...

  event.stopPropagation()
})

Event.preventDefault

Calling the preventDefault() method of the event object will cancel the default handling that the browser is programmed to execute.

Opening a new page on an a element click event, for example.

Or submitting a form on the submit event.

Calling preventDefault() is what you need to do to completely customize the action. Perhaps by creating a fetch request to load some JSON instead of opening a new page on a link click.

Other event handlers defined on this same element will execute. Unless you call event.stopImmediatePropagation().

Returning [object Object]

This is especially confusing to former (or current) jQuery developers. In jQuery, returning false from an event handler automatically called Event.preventDefault and Event.stopPropagation for us.

In vanilla JavaScript, return false in an event handler does nothing.

β†’ Download my free JavaScript Handbook!

THE VALLEY OF CODE

THE WEB DEVELOPER's MANUAL

You might be interested in those things I do:

  • Learn to code in THE VALLEY OF CODE, your your web development manual
  • Find a ton of Web Development projects to learn modern tech stacks in practice in THE VALLEY OF CODE PRO
  • I wrote 16 books for beginner software developers, DOWNLOAD THEM NOW
  • Every year I organize a hands-on cohort course coding BOOTCAMP to teach you how to build a complex, modern Web Application in practice (next edition February-March-April-May 2024)
  • Learn how to start a solopreneur business on the Internet with SOLO LAB (next edition in 2024)
  • Find me on X

Related posts that talk about js: