Error [ERR_REQUIRE_ESM]: require() of ES Module /app/node_modules/chalk/source/index.js from /app/index.js not supported.
Încerci să încarci cu require un modul care e scris ca modul ES (multe pachete noi, ca chalk 5 sau node-fetch 3, sunt doar ESM). Folosește import în loc de require, un import() dinamic, sau o versiune mai veche a pachetului care are CommonJS.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul înseamnă: un fișier CommonJS (index.js, cu require) a cerut un fișier care este modul ES (.mjs, sau .js dintr-un pachet cu "type": "module"). În versiunile Node de până la 20 și 22.11 asta nu era permis deloc. Sub mesaj, Node îți sugerează să schimbi require cu un import() dinamic.
În Node 22.12+ și Node 24, require() poate încărca module ES sincrone, așa că eroarea apare mai rar. Rămâne însă un caz: modulul ES (sau un modul pe care îl importă) folosește await la nivelul de sus. Atunci primești varianta ERR_REQUIRE_ASYNC_MODULE, cu aceeași reparație.
Cel mai des o vezi la pachete care au trecut doar pe ESM la o versiune majoră nouă: chalk@5, node-fetch@3, nanoid@4, inquirer@9.
De ce apare: cauzele frecvente
1Pachet care e doar ESM
const chalk = require("chalk"); // chalk 5import chalk from "chalk"; // fișier modul ES
// sau: const { default: chalk } = await import("chalk");Un pachet ESM se încarcă natural cu import. Dintr-un fișier CommonJS folosești import() dinamic, care întoarce o promisiune.
2Modul ES cu await la nivelul de sus
// config.mjs: export default await citesteSetari();
const config = require("./config.mjs");async function main() {
const { default: config } = await import("./config.mjs");
console.log(config);
}
main();require e sincron și nu poate aștepta un modul care are await la nivelul de sus. import() așteaptă modulul.
3Vrei să rămâi pe CommonJS cu un pachet vechi
npm install node-fetch
# const fetch = require("node-fetch");npm install node-fetch@2
# sau folosește fetch, inclus în Node 18+Versiunile mai vechi ale acestor pachete au încă CommonJS. Pentru fetch, Node are deja funcția globală.
Repară eroarea, direct în pagină
index.js este CommonJS și încarcă modulul ES config.mjs cu require. Modulul își citește setările cu await la nivelul de sus, iar require dă eroare (ERR_REQUIRE_ESM / ERR_REQUIRE_ASYNC_MODULE). Încarcă modulul cu import() dinamic într-o funcție async, ca programul să afișeze portul și mediul.
const config = require("./config.mjs");
console.log(`Port: ${config.port}`);
console.log(`Mediu: ${config.mediu}`);Port: 8080 Mediu: productie
Indiciu
const { default: config } = await import("./config.mjs"); merge doar într-o funcție async.
Reparația
async function main() {
const { default: config } = await import("./config.mjs");
console.log(`Port: ${config.port}`);
console.log(`Mediu: ${config.mediu}`);
}
main();De ce merge
require este sincron: trebuie să întoarcă imediat exporturile modulului. Un modul ES cu await la nivelul de sus nu are exporturile gata imediat, așa că Node refuză să-l încarce cu require. import() dinamic întoarce o promisiune care se rezolvă abia după ce modulul a terminat de rulat, iar exportul implicit se află în proprietatea default. Funcția async main() îți permite să folosești await într-un fișier CommonJS.
Alte forme ale mesajului
Error [ERR_REQUIRE_ASYNC_MODULE]: require() cannot be used on an ESM graph with top-level await. Use import() instead.Error [ERR_REQUIRE_ESM]: require() of ES Module /app/config.mjs not supported.Instead change the require of index.js in /app/index.js to a dynamic import() which is available in all CommonJS modules.
Cum o eviți pe viitor
- Pentru proiecte noi, folosește modulele ES (
"type": "module"șiimport): merg cu toate pachetele. - Înainte de a actualiza un pachet la o versiune majoră, citește notele de lansare: multe trec doar pe ESM.
- Într-un proiect CommonJS, încarcă pachetele ESM cu
await import("pachet")într-o funcțieasync. - Ține Node la zi: versiunile 22.12+ pot face
requirepe majoritatea modulelor ES.
Întrebări frecvente
De ce merge la un coleg și la mine nu?
Probabil aveți versiuni diferite de Node. Începând cu Node 22.12, require() poate încărca module ES fără await la nivelul de sus; pe versiuni mai vechi primești ERR_REQUIRE_ESM.
Ce întoarce import() dinamic?
O promisiune cu obiectul modulului. Exportul implicit e în proprietatea default: const { default: chalk } = await import("chalk").
Erori înrudite
SyntaxError: Cannot use import statement outside a module Node încarcă fișierul ca modul CommonJS, unde import nu e permis. Ori treci pe require, ori spui că fișierul e modul ES: extensia .mjs sau "type": "module" în package.json. Fișierele .cjs și proiectele cu "type": "commonjs" acceptă doar require. ReferenceError: require is not defined in ES module scope, you can use import instead Fișierul este modul ES (are import/export, extensia .mjs sau "type": "module" în package.json), iar în modulele ES require nu există. Înlocuiește require cu import: const fs = require("fs") devine import fs from "fs". Error: Cannot find module 'lodash' Pachetul cerut nu este instalat în node_modules: ai uitat npm install, l-ai instalat în alt dosar sau numele e scris greșit. Rulează npm install lodash (sau npm install dacă e deja în package.json) în dosarul proiectului, ori folosește o funcție inclusă în Node. Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
