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.
Î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ăstrezirequireși muțiawaitîntr-o funcțieasyncpe care o apelezi.If the code is intended to be an ES module, replace require() with import: păstreziawaitla nivelul de sus și schimbi toaterequireînimport.
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
const fs = require("fs/promises");
const text = await fs.readFile("note.txt", "utf8");
console.log(text);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
const fs = require("fs/promises");
const date = JSON.parse(await fs.readFile("date.json", "utf8"));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
const express = require("express");
const config = await incarcaConfig();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ă 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.
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`);Comenzi: 3 Total: 385 lei
Indiciu
Mută codul cu await într-o funcție async function main() și apeleaz-o.
Reparația
const fs = require("fs/promises");
async function main() {
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`);
}
main();De ce merge
Fișierul avea și require (doar CommonJS), și await la nivelul de sus (doar module ES), deci Node nu putea alege un format. În funcția async main(), await e permis și în CommonJS, așa că fișierul rămâne CommonJS, require funcționează, iar comenzile sunt citite și însumate.
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 modulescode: 'ERR_AMBIGUOUS_MODULE_SYNTAX'
Cum o eviți pe viitor
- Hotărăște tipul proiectului din
package.json:"type": "module"pentruimport,"type": "commonjs"pentrurequire. - 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) saucreateRequire.
Î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
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". 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. Warning: Detected unsettled top-level await at file:///app/index.js:9 Un await de la nivelul de sus al unui modul ES așteaptă o promisiune care nu se mai rezolvă niciodată, iar Node se oprește cu codul de ieșire 13. De obicei lipsește apelul resolve() în new Promise sau evenimentul așteptat nu mai vine. Asigură-te că promisiunea se rezolvă sau se respinge pe orice drum. Î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.
