mdn/content

Misleading sentence in dispatchEvent() page

Open

#43519 opened on Mar 22, 2026

View on GitHub
 (7 comments) (0 reactions) (0 assignees)Markdown (8,900 stars) (22,427 forks)batch import
Content:WebAPIgood first issue

Description

MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/EventTarget/dispatchEvent

What specific section or headline is this issue about?

Unlike "native" events, which are fired by the browser and invoke event handlers asynchronously via the event loop,

What information was incorrect, unhelpful, or incomplete?

I think this sentence:

Unlike "native" events, which are fired by the browser and invoke event handlers asynchronously via the event loop

Is misleading.

AFAIK, Native events puts "dispatchEvent" calls on the event loop. Once those are called, the rest is still synchronous, meaning: the event handling itself run synchronously, including checking for registered event handlers and running them - synchronously.

The way that sentence is phrased, could be interpreted as though the event handler functions themselves run "asynchronously" - or are put on the Event Loop - but they are registered/saved on the element implementing EventTarget - and run "from there".

What did you expect to see?

Maybe: Unlike "native" events, which are fired by the browser and invoke dispatchEvent asynchronously via the [event loop]

Do you have any supporting links, references, or citations?

No response

Do you have anything more you want to share?

No response

Contributor guide

Tech stack
javascript
Domain
documentation
Issue type
documentation
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
1
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
under 1 hour
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
fresh
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
None
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
95
Research direction
The issue suggests a misleading sentence in the dispatchEvent() MDN page at https://developer.mozilla.org/en US/docs/Web/API/EventTarget/dispatchEvent. The sentence currently reads: 'Unlike "native" events, which are fired by the browser and invoke event handlers asynchronously via the event loop.' The reporter proposes rewording to clarify that native events dispatch the event asynchronously, but the handlers run synchronously. Specific files to modify are likely in the mdn/content repository under files/en us/web/api/eventtarget/dispatchevent/index.md. No linked PRs or assignees exist, so this is available for a newcomer to propose a precise wording change.