module: mark require(esm) as stable

joyeecheung · aduh95 · commit 8b6be3fe1445 · 2026-04-08T23:52:59.000+02:00
This has been released to all active LTS release lines and many popular packages have been shipping ESM-only distributions based on the existence of this feature on active LTS. The current documented behaviors are unlikely to change in a breaking manner within a major release - as everything with the module loaders, there can always be subtle changes to undocumented surface that can break edge cases that assume undocumented behaviors, due to Hyrum's law; but the stability of this feature is now not different than any other stable parts of the module loader. It's time to mark it as stable. PR-URL: #60959 Reviewed-By: Jacob Smith <jacob@frende.me> Reviewed-By: Marco Ippolito <marcoippolito54@gmail.com> Reviewed-By: Jordan Harband <ljharb@gmail.com> Reviewed-By: Matteo Collina <matteo.collina@gmail.com>
diff --git a/doc/api/cli.md b/doc/api/cli.md
@@ -1913,6 +1913,10 @@ added:
   - v22.0.0
   - v20.17.0
 changes:
+  - version:
+    - REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/60959
+    description: This flag is no longer experimental.
   - version:
     - REPLACEME
     pr-url: https://github.com/nodejs/node/pull/60959
@@ -1926,8 +1930,6 @@ changes:
     description: This is now false by default.
 -->
 
-> Stability: 1.2 - Release Candidate
-
 Disable support for loading a synchronous ES module graph in `require()`.
 
 See [Loading ECMAScript modules using `require()`][].
diff --git a/doc/api/errors.md b/doc/api/errors.md
@@ -2657,8 +2657,6 @@ A QUIC session failed because version negotiation is required.
 
 ### `ERR_REQUIRE_ASYNC_MODULE`
 
-> Stability: 1 - Experimental
-
 When trying to `require()` a [ES Module][], the module turns out to be asynchronous.
 That is, it contains top-level await.
 
@@ -2670,8 +2668,6 @@ before looking for the top-level awaits).
 
 ### `ERR_REQUIRE_CYCLE_MODULE`
 
-> Stability: 1 - Experimental
-
 When trying to `require()` a [ES Module][], a CommonJS to ESM or ESM to CommonJS edge
 participates in an immediate cycle.
 This is not allowed because ES Modules cannot be evaluated while they are
diff --git a/doc/api/modules.md b/doc/api/modules.md
@@ -175,6 +175,10 @@ added:
   - v22.0.0
   - v20.17.0
 changes:
+  - version:
+    - REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/60959
+    description: This feature is no longer experimental.
   - version:
     - v23.5.0
     - v22.13.0
@@ -195,8 +199,6 @@ changes:
     description: Support `'module.exports'` interop export in `require(esm)`.
 -->
 
-> Stability: 1.2 - Release candidate
-
 The `.mjs` extension is reserved for [ECMAScript Modules][].
 See [Determining module system][] section for more info
 regarding which files are parsed as ECMAScript modules.
