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

ReferenceError: __dirname is not defined in ES module scope

Pe scurt

Î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

Greșit
JavaScript
import path from "path";
const cale = path.join(__dirname, "date.json");
Corect
JavaScript
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

Greșit
JavaScript
const dir = __dirname;
Corect
JavaScript
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

Greșit
JavaScript
console.log(`Rulez ${__filename}`);
Corect
JavaScript
console.log(`Rulez ${import.meta.filename}`);

La fel ca __dirname, __filename există doar în CommonJS.

Repară tu

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.

Codul care dă eroarea
JavaScript
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`);
După reparație, programul afișează
Citesc produse.json
- Cafea: 42 lei
- Ceai: 18 lei
Indiciu

În modulele ES dosarul fișierului curent este import.meta.dirname.

Alte forme ale mesajului

  • ReferenceError: __filename is not defined in ES module scope
  • ReferenceError: __dirname is not defined

Cum o eviți pe viitor

  • În proiectele cu import, folosește import.meta.dirname și import.meta.filename.
  • Când transformi un proiect din CommonJS în ES, caută în tot proiectul __dirname, __filename, require și module.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

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