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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
__dirname (dosarul fișierului curent) și __filename (calea lui completă) sunt variabile pe care Node le dă doar modulelor CommonJS. Un modul ES (cu import, extensia .mjs sau "type": "module") nu le are, așa că folosirea lor dă ReferenceError.
În modulele ES informația există în import.meta: import.meta.url este adresa fișierului (file:///app/index.js), iar în versiunile noi de Node ai direct import.meta.dirname și import.meta.filename.
Eroarea apare des la mutarea unui proiect Express de pe require pe import, de exemplu în express.static(path.join(__dirname, "public")) sau când citești un fișier aflat lângă script.
De ce apare: cauzele frecvente
1__dirname copiat dintr-un exemplu CommonJS
import path from "path";
const cale = path.join(__dirname, "date.json");import path from "path";
const cale = path.join(import.meta.dirname, "date.json");import.meta.dirname e echivalentul lui __dirname în modulele ES (Node 20.11 și mai nou).
2Versiuni mai vechi de Node
const dir = __dirname;import { fileURLToPath } from "url";
import path from "path";
const __filename = fileURLToPath(import.meta.url);
const __dirname = path.dirname(__filename);import.meta.url e un URL file://. fileURLToPath îl transformă în cale, iar path.dirname îți dă dosarul.
3__filename în modul ES
console.log(`Rulez ${__filename}`);console.log(`Rulez ${import.meta.filename}`);La fel ca __dirname, __filename există doar în CommonJS.
Repară eroarea, direct în pagină
Programul este modul ES și dă ReferenceError: __dirname is not defined in ES module scope. Construiește calea către date/produse.json pornind de la dosarul modulului, cu echivalentul din modulele ES, ca programul să afișeze numele fișierului și produsele.
import fs from "fs";
import path from "path";
const cale = path.join(__dirname, "date", "produse.json");
console.log(`Citesc ${path.basename(cale)}`);
const produse = JSON.parse(fs.readFileSync(cale, "utf8"));
for (const p of produse) console.log(`- ${p.nume}: ${p.pret} lei`);Citesc produse.json - Cafea: 42 lei - Ceai: 18 lei
Indiciu
În modulele ES dosarul fișierului curent este import.meta.dirname.
Reparația
import fs from "fs";
import path from "path";
const cale = path.join(import.meta.dirname, "date", "produse.json");
console.log(`Citesc ${path.basename(cale)}`);
const produse = JSON.parse(fs.readFileSync(cale, "utf8"));
for (const p of produse) console.log(`- ${p.nume}: ${p.pret} lei`);De ce merge
Fișierul folosește import, deci rulează ca modul ES, unde Node nu mai definește __dirname. import.meta.dirname îți dă dosarul în care se află modulul, iar path.join lipește bucățile căii cu separatorul corect. Calea rezultată e absolută, deci fișierul e găsit indiferent din ce dosar pornești programul. În versiuni mai vechi de Node obțineai același lucru cu path.dirname(fileURLToPath(import.meta.url)).
Alte forme ale mesajului
ReferenceError: __filename is not defined in ES module scopeReferenceError: __dirname is not defined
Cum o eviți pe viitor
- În proiectele cu
import, foloseșteimport.meta.dirnameșiimport.meta.filename. - Când transformi un proiect din CommonJS în ES, caută în tot proiectul
__dirname,__filename,requireșimodule.exports. - Pentru căi către fișierele de lângă script, construiește calea absolută din dosarul modulului, nu te baza pe dosarul din care rulezi
node.
Întrebări frecvente
Pot să folosesc doar căi relative, fără __dirname?
Căile relative din fs pornesc din dosarul curent al procesului (process.cwd()), nu din dosarul fișierului. Dacă rulezi scriptul din alt dosar, nu mai găsește fișierele. De aceea se construiește calea din dosarul modulului.
De ce Node a renunțat la __dirname în modulele ES?
Modulele ES sunt un standard comun cu browserul, unde nu există dosare, ci URL-uri. Informația despre fișier stă în import.meta.url, iar Node adaugă import.meta.dirname ca scurtătură.
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". ReferenceError: module is not defined in ES module scope Folosești module.exports într-un fișier care e modul ES (are import, extensia .mjs sau "type": "module"). În modulele ES exporți cu export: module.exports = { a, b } devine export { a, b } sau export default. Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. Î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.
