[BUG] ExperimentalWarning: Support for loading ES Module in require() is an experimental feature and might change at any time

[alexsch01]

Is there an existing issue for this?

• I have searched the existing issues

This issue exists in the latest npm version

• I am using the latest npm

Current Behavior

When installing any package with Node.js v23.0.0 and npm v10.9.0, I get the following warning

(node:10424) ExperimentalWarning: Support for loading ES Module in require() is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)

Expected Behavior

No response

Steps To Reproduce

No response

Environment

• npm: 10.9.0
• Node.js: 23.0.0
• OS Name: Windows 10 22H2
• npm config: default

; node bin location = C:\Program Files\nodejs\node.exe
; node version = v23.0.0
; npm local prefix = C:\Users\$USER\Downloads\test
; npm version = 10.9.0
; cwd = C:\Users\$USER\Downloads\test
; HOME = C:\Users\$USER
; Run `npm config ls -l` to show all defaults.

[shadowspawn]

This is triggered by the experimental --experimental-require-module flag being made the default behaviour in Node.js 23. Related links:

• debug causes npm to always issue an experimental ESM warning in node 23 debug-js/debug#975
• 2024-10-16, Version 23.0.0 (Current) nodejs/node#55338 (comment)
• module: unflag --experimental-require-module nodejs/node#55085

[MikeMcC399]

It's not necessary to install anything with npm to provoke the ExperimentalWarning.

For example, even with no npm modules installed, executing npm view npm version results in the ExperimentalWarning:

$ npm view npm version
(node:5212) ExperimentalWarning: Support for loading ES Module in require() is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
10.9.0

Ubuntu 24.04.1 LTS
Node.js v23.0.0
npm 10.9.0 (latest)

Same ExperimentalWarning for many other CLI commands from https://docs.npmjs.com/cli/v10/commands:

npm audit
npm ci
npm doctor
npm init
npm install
npm install-ci-test
npm ls
npm outdated
npm prune
npm repo
npm show
... etc

[MikeMcC399]

• See also discussion in Can we supress the new experimental warning from the new default require(esm) setting? nodejs/node#55417

[MikeMcC399]

Setting the environment variable NODE_OPTIONS='--trace-warnings' produces some trace output.

$ NODE_OPTIONS='--trace-warnings' npm view npm view
(node:6610) ExperimentalWarning: Support for loading ES Module in require() is an experimental feature and might change at any time
    at emitExperimentalWarning (node:internal/util:273:11)
    at loadESMFromCJS (node:internal/modules/cjs/loader:1388:5)
    at Module._compile (node:internal/modules/cjs/loader:1525:5)
    at Object..js (node:internal/modules/cjs/loader:1680:16)
    at Module.load (node:internal/modules/cjs/loader:1328:32)
    at Function._load (node:internal/modules/cjs/loader:1138:12)
    at TracingChannel.traceSync (node:diagnostics_channel:315:14)
    at wrapModuleLoad (node:internal/modules/cjs/loader:218:24)
    at Module.require (node:internal/modules/cjs/loader:1350:12)
    at require (node:internal/modules/helpers:138:16)

[avivkeller]

FYI the ESM being require()d is supports-color.

[MikeMcC399]

@redyetidev

FYI the ESM being require()d is supports-color.

You're right!

cli/package.json

Line 113 in 780afc5

"supports-color": "^9.4.0",

where [email protected] and above is pure ESM

• As identified by @ljharb in debug causes npm to always issue an experimental ESM warning in node 23 debug-js/debug#975 and relayed above by @shadowspawn , debug is using the following code to check on the availability of supports-color.

const supportsColor = require('supports-color'); 

where debug is effectively allowing an ESM version of supports-color to be installed and used:

  "peerDependenciesMeta": {
    "supports-color": {
      "optional": true
    }

So I guess the underlying issue debug-js/debug#975 needs to be resolved by debug.

[MikeMcC399]

• To test, I downgraded to [email protected] prior to PR fix: better color support detection #6556 in [email protected]

npm install [email protected] -g

and there was no more warning under Node.js v23.0.0 from

npm view npm version

[MikeMcC399]

Under Node.js v23.1.0 the warning provides additional debugging information which confirms the previous analysis:

$ npm view npm version
(node:13088) ExperimentalWarning: CommonJS module /home/mike/n/lib/node_modules/npm/node_modules/debug/src/node.js is loading ES Module /home/mike/n/lib/node_modules/npm/node_modules/supports-color/index.js using require().
Support for loading ES Module in require() is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
10.9.0

• Message enhancement through module: include module information in require(esm) warning nodejs/node#55397

[deleonjulio]

Out of nowhere, npm install and npm start doesnt work in my project. I have to downgrade my node version to make it work.

[MikeMcC399]

@deleonjulio

Out of nowhere, npm install and npm start doesnt work in my project. I have to downgrade my node version to make it work.

That sounds like a different issue. This issue is about an ExperimentalWarning only, where npm continues to work.

[SparK-Cruz]

What can we do other than rewrite everything between npm to debug, inclusive, in ESM?

[ljharb]

@SparK-Cruz you can't do anything, whatsoever. Only node, npm, or debug, can do something about it.

[SparK-Cruz]

@SparK-Cruz you can't do anything, whatsoever. Only node, npm, or debug, can do something about it.

@ljharb We can always open a pull request... if gets approved or not is another story. Worst case scenario I can fork it and add it to the AUR.

[ljharb]

@SparK-Cruz yes, a PR to debug would be a possible path forward.

Forking things to AUR without the consent of the maintainer doesn’t actually help the ecosystem, though, and it makes things worse for AUR users because they’re not really using the actual software.

[mantoni]

Hm, I think the cause of this is npm cli directly depending on a different major version of supports-color than chalk and debug. I tried downgrading to v7.x in #7887 and it fixes the problem and seems to work fine.

[wellwelwel]

I opened a PR with a really simple approach to fix it from supports-color side, by adding an automation to also export the index.js (ESM) to index.cjs. This allows the supports-color to support both CommonJS, ES Modules and browsers, fixing the issue in both debug and npm/cli, and allowing Node.js to keep the experimental warning.

Also, no changes would be necessary either on the debug or npm/cli side (except maybe forcing an update to the new supports-color version, if approved).

• feat: support for CommonJS chalk/supports-color#156

---

EDIT: Unfortunately, supports-color's decision is in fact not to be compatible with CommonJS.

[damisparks]

I get this error on npm publish:

(node:85003) ExperimentalWarning: Support for loading ES Module in require() is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
npm error code ENOENT
npm error syscall open

I was only able to publish by using node 22.

[ljharb]

@damisparks node v23.0.0 is broken, so you'd need to be on v23.1.0. The experimental warning would still occur, though.

[damisparks]

@ljharb After upgrading to v23.1.0 , I could publish.
I still see the experimental warning, as you said.

(node:19390) ExperimentalWarning: CommonJS module /Users/damisparks/.nvm/versions/node/v23.1.0/lib/node_modules/npm/node_modules/debug/src/node.js is loading ES Module /Users/damisparks/.nvm/versions/node/v23.1.0/lib/node_modules/npm/node_modules/supports-color/index.js using require().
Support for loading ES Module in require() is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)

[ljharb]

@planetarquasar those are just log messages, it shouldn't interfere with a build process. you can set NODE_OPTIONS='--disable-warning=ExperimentalWarning', though, and suppress them.

[planetarquasar]

Where should I put this?

[ljharb]

in your environment - it's an environment variable. Happy to help with further questions, but let's please not continue pinging people by commenting on this issue :-)

(npm folks, feel free to hide some of these tangents as off topic)

[gba-foundever]

For information, this 'WARNING' was make my yoeman installation not working with issue: yeoman/yeoman#1778

putting
export NODE_OPTIONS='--disable-warning=ExperimentalWarning' in bash removed the WARNING and the issue

[orome]

For information, this 'WARNING' was make my yoeman installation not working with issue: yeoman/yeoman#1778

putting export NODE_OPTIONS='--disable-warning=ExperimentalWarning' in bash removed the WARNING and the issue

So is this what we should all be doing? Any reason not to?

[shivanraptor]

Where should I put this?

Example:

NODE_OPTIONS='--disable-warning=ExperimentalWarning' npm i

[wraithgar]

This was fixed in the latest versions of both npm 9 and 10

Debug was updated but this didn't resolve the issue. See later comments in this issue.

[songyang-dev]

This is still happening to me. I'll make a new issue

[shivanraptor]

This is still happening to me. I'll make a new issue

Confirmed. I use npm version 10.9.0, this issue still appears.

Environment:

• macOS 15.1.1
• npm 10.9.0
• node v23.3.0
• vite 5.4.11
• react 18.3.1

package.json

{
  "name": "my-project-name",
  "private": true,
  "version": "0.0.0",
  "type": "module",
  "scripts": {
    "dev": "vite",
    "build": "tsc -b && vite build",
    "lint": "eslint .",
    "preview": "vite preview"
  },
  "dependencies": {
    "@chatui/core": "^2.4.2",
    "react": "^18.3.1",
    "react-dom": "^18.3.1"
  },
  "devDependencies": {
    "@eslint/js": "^9.13.0",
    "@types/react": "^18.3.12",
    "@types/react-dom": "^18.3.1",
    "@vitejs/plugin-react-swc": "^3.5.0",
    "eslint": "^9.13.0",
    "eslint-plugin-react-hooks": "^5.0.0",
    "eslint-plugin-react-refresh": "^0.4.14",
    "globals": "^15.11.0",
    "typescript": "~5.6.2",
    "typescript-eslint": "^8.11.0",
    "vite": "^5.4.10"
  }
}

[wraithgar]

debug was updated in npm, but didn't fix the issue. This is not something npm can fix. This is an issue with node and/or debug. Please follow debug-js/debug#975 for more info.

This should not be a problem in node 22 anymore (ref: debug-js/debug#975 (comment)).

[ljharb]

(it's something npm can work around, by pinning to an older version of supports-color, but it's best resolved in node itself)

[Veronicandemo]

I downgraded to node version (20.18.1). and it resolved the issue.

[damisparks]

I downgraded to node version (20.18.1). and it resolved the issue.

@Veronicandemo You could do something similar to what @nursoda did here.

"NODE_OPTIONS='--disable-warning=ExperimentalWarning' npm install"

See datenschutz-individuell/twofactor_email@160a26c#diff-60f21b0825bc73d363d1e587d92fd2ce197c32fd602dd9f32e078e55793bd431R4

[MikeMcC399]

• This issue is fixed in Node.js v23.4.0
  see PR module: do not warn when require(esm) comes from node_modules nodejs/node#55960

BEFORE (Node.js v23.3.0)

$ node -v
v23.3.0
$ npm -v
10.9.0
$ npm view npm version
(node:5688) ExperimentalWarning: CommonJS module C:\Users\mikem\AppData\Roaming\nvm\v23.3.0\node_modules\npm\node_modules\debug\src\node.js is loading ES Module C:\Users\mikem\AppData\Roaming\nvm\v23.3.0\node_modules\npm\node_modules\supports-color\index.js using require().
Support for loading ES Module in require() is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
10.9.2

AFTER (Node.js v23.4.0)

$ node -v
v23.4.0
$ npm -v
10.9.2
$ npm view npm version
10.9.2

[lutfiadnan92]

@deleonjulio

Out of nowhere, npm install and npm start doesnt work in my project. I have to downgrade my node version to make it work.

That sounds like a different issue. This issue is about an ExperimentalWarning only, where npm continues to work.

yes, it happened on node v23
try using v22

[aqlnce-af]

I was getting this error on MacOS as well. Updating node to v22.12.0 fixed the problem.

[xLuisCumbi]

I upgrade to node 23.6.0 and warning disappear, lets give a try if you need to use ^23 version