Skip to content

Docs Incorrectly State setImmediate() Runs Before Timers #57993

Open
nodejs/nodejs.org
#7677
@pakobarbakadze

Description

@pakobarbakadze

Affected URL(s)

https://nodejs.org/en/learn/asynchronous-work/discover-promises-in-nodejs#advanced-promise-methods

Description of the problem

When to Use Each
Use queueMicrotask() for tasks that need to run immediately after the current script and before any I/O or timer callbacks, typically for Promise resolutions.
Use process.nextTick() for tasks that should execute before any I/O events, often useful for deferring operations or handling errors synchronously.
Use setImmediate() for tasks that should run after I/O events but before timers.

This line appears to be incorrect. According to the Node.js event loop phases, setImmediate() callbacks are executed during the check phase, which occurs after I/O callbacks and after timers have already been processed in the timers phase.

Activity

added
docIssues and PRs related to the documentations.
on Apr 23, 2025
avivkeller

avivkeller commented on Apr 23, 2025

@avivkeller
Member

Thank's for pointing that out! If you'd like to see a change in the learn articles, feel free to submit a PR to nodejs/nodejs.org.

pakobarbakadze

pakobarbakadze commented on Apr 23, 2025

@pakobarbakadze
Author

Hello, @avivkeller. I have opened PR. Let me know if you'd like any adjustments!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    docIssues and PRs related to the documentations.

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

      Development

      Participants

      @avivkeller@pakobarbakadze

      Issue actions

        Docs Incorrectly State setImmediate() Runs Before Timers · Issue #57993 · nodejs/node