SyntaxError: Cannot use 'import.meta' outside a module
import.meta există doar în modulele ES, iar fișierul tău e rulat ca CommonJS. În CommonJS ai deja __dirname și __filename, deci înlocuiește path.dirname(fileURLToPath(import.meta.url)) cu __dirname, sau treci fișierul pe module ES cu "type": "module" ori extensia .mjs.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
import.meta e un obiect special al modulelor ES: import.meta.url e adresa file:// a fișierului curent, iar în versiunile noi de Node ai și import.meta.dirname și import.meta.filename. În CommonJS acest obiect nu există, iar parserul refuză sintaxa încă înainte de rulare.
Eroarea apare tipic când copiezi rețeta pentru modulele ES (const __dirname = path.dirname(fileURLToPath(import.meta.url))) într-un fișier CommonJS: un proiect cu "type": "commonjs" în package.json, un fișier .cjs sau cod rulat de unelte care transformă totul în CommonJS (Jest, ts-node configurat pe CommonJS).
Mesajul arată linia și pune ^^^^ sub meta. Repararea depinde de ce vrei: în CommonJS folosești variabilele care există deja (__dirname, __filename), în modulele ES păstrezi import.meta și scrii importurile cu import.
De ce apare: cauzele frecvente
1Rețeta pentru module ES copiată în CommonJS
const path = require("path");
const { fileURLToPath } = require("url");
const dosar = path.dirname(fileURLToPath(import.meta.url));const path = require("path");
const dosar = __dirname;În CommonJS, Node definește singur __dirname pentru fiecare fișier. Rețeta cu import.meta.url e necesară doar în modulele ES, unde __dirname lipsește.
2Fișierul ar trebui să fie modul ES
// config.cjs
console.log(import.meta.url);// config.mjs
console.log(import.meta.url);Extensia .mjs (sau "type": "module") face fișierul modul ES, iar acolo import.meta e valid.
3Teste rulate de Jest în mod CommonJS
// sursa folosește import.meta.url
// iar Jest transformă fișierul în CommonJS// rulează Jest cu suport ESM (NODE_OPTIONS=--experimental-vm-modules)
// sau mută calculul căii într-un modul mic, înlocuit în testeUnealta transformă codul, nu Node. Fie activezi modulele ES în unealtă, fie izolezi partea care folosește import.meta.
Repară eroarea, direct în pagină
Proiectul are "type": "commonjs", iar index.js dă SyntaxError: Cannot use 'import.meta' outside a module, pentru că dosarul aplicației e calculat cu rețeta pentru module ES. Calculează-l cu variabila pe care CommonJS o oferă deja, ca programul să afișeze dosarul și setările din config.json.
const fs = require("fs");
const path = require("path");
const { fileURLToPath } = require("url");
const dosar = path.dirname(fileURLToPath(import.meta.url));
const config = JSON.parse(fs.readFileSync(path.join(dosar, "config.json"), "utf8"));
console.log(`Dosarul aplicației: ${path.basename(dosar)}`);
console.log(`Magazin: ${config.nume}, port ${config.port}`);Dosarul aplicației: app Magazin: Cafeneaua Verde, port 3000
Indiciu
În CommonJS, dosarul fișierului curent e în __dirname; importul din url nu mai e necesar.
Reparația
const fs = require("fs");
const path = require("path");
const dosar = __dirname;
const config = JSON.parse(fs.readFileSync(path.join(dosar, "config.json"), "utf8"));
console.log(`Dosarul aplicației: ${path.basename(dosar)}`);
console.log(`Magazin: ${config.nume}, port ${config.port}`);De ce merge
Fișierul e CommonJS, deci parserul nu acceptă import.meta, care există doar în modulele ES. CommonJS îți dă însă direct __dirname, dosarul în care se află fișierul, așa că nu mai ai nevoie nici de import.meta.url, nici de fileURLToPath. Calea către config.json construită din __dirname funcționează indiferent din ce dosar pornești programul.
Alte forme ale mesajului
SyntaxError: Cannot use 'import.meta' outside a module at wrapSafe (node:internal/modules/cjs/loader)SyntaxError: import.meta may appear only with 'sourceType: "module"'error TS1343: The 'import.meta' meta-property is only allowed when the '--module' option is 'es2020', 'es2022', 'esnext', 'system', 'node16', 'node18', 'node20', or 'nodenext'.
Cum o eviți pe viitor
- Hotărăște tipul modulelor în
package.jsonși ține-te de el în tot proiectul. - În CommonJS folosește
__dirnameși__filename; în modulele ES foloseșteimport.meta.dirname(Node 20.11+) saufileURLToPath(import.meta.url). - Când copiezi o rețetă, uită-te dacă exemplul folosește
importsaurequire: îți spune pentru ce tip de modul e scrisă.
Întrebări frecvente
E aceeași problemă ca __dirname is not defined?
Este inversul ei. __dirname is not defined in ES module scope apare când folosești variabila CommonJS într-un modul ES; aici folosești obiectul modulelor ES într-un fișier CommonJS.
Ce este import.meta.dirname?
O scurtătură adăugată în Node 20.11 și 21.2: dosarul fișierului curent, direct ca text. Înlocuiește combinația path.dirname(fileURLToPath(import.meta.url)), dar există tot doar în modulele ES.
Erori înrudite
ReferenceError: __dirname is not defined in ES module scope În modulele ES nu există __dirname și __filename. Folosește import.meta.dirname și import.meta.filename (Node 20.11+) sau calculează-le din import.meta.url cu fileURLToPath și path.dirname. SyntaxError: Unexpected token 'export' Fișierul folosește export (sintaxa modulelor ES), dar Node îl rulează ca CommonJS, de obicei pentru că package.json are "type": "commonjs" sau fișierul are extensia .cjs. Fie scrii exporturile cu module.exports, fie treci proiectul pe module ES cu "type": "module". 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. Î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.
