Wrong example

This example from the documentation (https://nodejs.org/api/process.html#when-to-use-queuemicrotask-vs-processnexttick)

import { nextTick } from 'node:process';
Promise.resolve().then(() => console.log(2));
queueMicrotask(() => console.log(3));
nextTick(() => console.log(1));
// Output:
// 1
// 2
// 3

doesn't work in Windows (node 16.13 and 18.11) and Ubuntu (node 18.11). Actual output is always

2
3
1

This looks like a documentation bug, but any explanation for this behavior in the main module would be appreciated.

interestingly it does work as documented when run as a commonjs module, either by requiring process or by using the global.

Yeah, looks like it was never tested when the mjs version was added. This is a known scheduling difference between cjs and mjs. The mjs example just needs to be updated to reflect the correct ordering. Interested in opening a PR?

I can put up a PR for a doc fix. I wonder tho if it would be good to add an additional note or comment about the different behavior in both module systems?

That would be helpful yes.

@jasnell

Any idea when this will be fixed? @jasnell

doc: clarify cjs/esm diff in `queueMicrotask()` vs `process.nextTick()`

Navigation Menu

Repository navigation

Wrong example #45048

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Wrong example #45048

Description

Activity

dnalborczyk commented on Oct 18, 2022

jasnell commented on Oct 18, 2022

dnalborczyk commented on Oct 19, 2022

jasnell commented on Oct 19, 2022

parmishh commented on Mar 2, 2023

nairihar commented on Jan 5, 2024

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions