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

ReferenceError: Cannot determine intended module format because both 'require' and top-level await are present. If the code is intended to be CommonJS, wrap await in an async function. If the code is intended to be an ES module, replace require() with import.

Pe scurt

În același fișier folosești și require() (CommonJS) și await la nivelul de sus (doar în module ES), iar Node nu știe ce fel de modul e. Alege unul: pune codul cu await într-o funcție async (rămâi pe CommonJS) sau înlocuiește require cu import (treci pe module ES).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Node 22 și 24 ghicesc tipul unui fișier .js fără "type" în package.json: dacă vede sintaxă de modul ES (import, export, await la nivelul de sus), îl încarcă drept modul ES. Problema apare când fișierul are și await la nivelul de sus, și require, care există doar în CommonJS.

Mesajul îți dă exact cele două ieșiri:

  • If the code is intended to be CommonJS, wrap await in an async function: păstrezi require și muți await într-o funcție async pe care o apelezi.
  • If the code is intended to be an ES module, replace require() with import: păstrezi await la nivelul de sus și schimbi toate require în import.

Codul erorii este ERR_AMBIGUOUS_MODULE_SYNTAX. În versiunile mai vechi de Node, același cod dădea SyntaxError: await is only valid in async functions and the top level bodies of modules.

De ce apare: cauzele frecvente

1Script CommonJS cu await direct

Greșit
JavaScript
const fs = require("fs/promises");

const text = await fs.readFile("note.txt", "utf8");
console.log(text);
Corect
JavaScript
const fs = require("fs/promises");

async function main() {
  const text = await fs.readFile("note.txt", "utf8");
  console.log(text);
}
main();

În CommonJS, await merge doar într-o funcție async. Funcția main păstrează fișierul CommonJS și require funcționează.

2Treci tot fișierul pe module ES

Greșit
JavaScript
const fs = require("fs/promises");
const date = JSON.parse(await fs.readFile("date.json", "utf8"));
Corect
JavaScript
import fs from "fs/promises";
const date = JSON.parse(await fs.readFile("date.json", "utf8"));

Fără require, fișierul e clar modul ES, iar await la nivelul de sus e permis.

3Cod copiat dintr-un exemplu ESM

Greșit
JavaScript
const express = require("express");
const config = await incarcaConfig();
Corect
JavaScript
const express = require("express");
incarcaConfig().then((config) => {
  // pornește aplicația cu config
});

Exemplele din documentații noi folosesc des top-level await. Într-un proiect CommonJS, înlocuiește-l cu .then() sau cu o funcție async.

Repară tu

Repară eroarea, direct în pagină

Scriptul CommonJS de mai jos citește comenzile din comenzi.json cu fs/promises, dar folosește await direct la nivelul de sus, lângă require, și primește Cannot determine intended module format. Păstrează require și repară scriptul ca să afișeze numărul de comenzi și totalul.

Codul care dă eroarea
JavaScript
const fs = require("fs/promises");

const comenzi = JSON.parse(await fs.readFile("comenzi.json", "utf8"));
const total = comenzi.reduce((s, c) => s + c.suma, 0);

console.log(`Comenzi: ${comenzi.length}`);
console.log(`Total: ${total} lei`);
După reparație, programul afișează
Comenzi: 3
Total: 385 lei
Indiciu

Mută codul cu await într-o funcție async function main() și apeleaz-o.

Alte forme ale mesajului

  • ReferenceError: Cannot determine intended module format because both 'require' and top-level await are present.
  • SyntaxError: await is only valid in async functions and the top level bodies of modules
  • code: 'ERR_AMBIGUOUS_MODULE_SYNTAX'

Cum o eviți pe viitor

  • Hotărăște tipul proiectului din package.json: "type": "module" pentru import, "type": "commonjs" pentru require.
  • Nu amesteca cele două stiluri în același fișier.
  • În CommonJS, pune codul principal într-o funcție async function main() și apelează main().catch(console.error).
  • Dacă ai nevoie de un singur pachet CommonJS într-un modul ES, folosește import (merge și pentru pachetele CommonJS) sau createRequire.

Întrebări frecvente

De ce nu primesc eroarea dacă scot require?

Fără require, module sau exports, Node vede doar sintaxă de modul ES (await la nivelul de sus) și încarcă fișierul ca modul ES. Problema e doar combinația.

Ce variantă să aleg?

Pentru un proiect nou, modulele ES (import) sunt standardul. Pentru un proiect existent plin de require, e mai simplu să pui await într-o funcție async și să schimbi totul mai târziu, dintr-odată.

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.