...
Eroare Node.js · Module CommonJS: require și module.exports

SyntaxError: Cannot use 'import.meta' outside a module

Pe scurt

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

Greșit
JavaScript
const path = require("path");
const { fileURLToPath } = require("url");
const dosar = path.dirname(fileURLToPath(import.meta.url));
Corect
JavaScript
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

Greșit
JavaScript
// config.cjs
console.log(import.meta.url);
Corect
JavaScript
// 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

Greșit
JavaScript
// sursa folosește import.meta.url
// iar Jest transformă fișierul în CommonJS
Corect
JavaScript
// rulează Jest cu suport ESM (NODE_OPTIONS=--experimental-vm-modules)
// sau mută calculul căii într-un modul mic, înlocuit în teste

Unealta transformă codul, nu Node. Fie activezi modulele ES în unealtă, fie izolezi partea care folosește import.meta.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
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.

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ște import.meta.dirname (Node 20.11+) sau fileURLToPath(import.meta.url).
  • Când copiezi o rețetă, uită-te dacă exemplul folosește import sau require: îț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

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