...
Eroare Node.js · Module ES: import, export și "type": "module"

Error [ERR_REQUIRE_ESM]: require() of ES Module /app/node_modules/chalk/source/index.js from /app/index.js not supported.

Pe scurt

Î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

Greșit
JavaScript
const chalk = require("chalk"); // chalk 5
Corect
JavaScript
import 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

Greșit
JavaScript
// config.mjs: export default await citesteSetari();
const config = require("./config.mjs");
Corect
JavaScript
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

Greșit
JavaScript
npm install node-fetch
# const fetch = require("node-fetch");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
const config = require("./config.mjs");

console.log(`Port: ${config.port}`);
console.log(`Mediu: ${config.mediu}`);
După reparație, programul afișează
Port: 8080
Mediu: productie
Indiciu

const { default: config } = await import("./config.mjs"); merge doar într-o funcție async.

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" și import): 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ție async.
  • Ține Node la zi: versiunile 22.12+ pot face require pe 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

← Toate erorile Node.js

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.