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

ReferenceError: module is not defined in ES module scope

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

module și exports sunt obiecte pe care Node le creează doar pentru fișierele CommonJS. Într-un modul ES nu există, deci prima linie care le atinge (de obicei module.exports = ... de la finalul fișierului) aruncă ReferenceError.

Observă că eroarea apare abia când execuția ajunge la linia respectivă: codul de deasupra rulează normal, așa că poți vedea câteva rânduri afișate înainte de eroare. Linia din mesaj îți arată exportul care trebuie schimbat.

Situația tipică: ai pus "type": "module" în package.json sau ai adăugat un import sus în fișier, dar exporturile au rămas în stilul vechi. Varianta cu exports.ceva = ... dă mesajul înrudit exports is not defined in ES module scope.

De ce apare: cauzele frecvente

1Export CommonJS într-un fișier cu import

Greșit
JavaScript
import path from "path";
function nume(f) { return path.parse(f).name; }
module.exports = { nume };
Corect
JavaScript
import path from "path";
function nume(f) { return path.parse(f).name; }
export { nume };

Primul import face fișierul modul ES, unde exporturile se scriu cu export.

2Export implicit

Greșit
JavaScript
module.exports = function formatLei(x) { return `${x} lei`; };
Corect
JavaScript
export default function formatLei(x) { return `${x} lei`; }

module.exports = valoare corespunde în modulele ES cu export default valoare.

3exports.ceva într-un modul ES

Greșit
JavaScript
exports.TVA = 0.19;
Corect
JavaScript
export const TVA = 0.19;

Și exports lipsește din modulele ES; folosești exporturi cu nume.

Repară tu

Repară eroarea, direct în pagină

Fișierul folosește import, deci e modul ES, dar la final exportă în stil CommonJS și dă ReferenceError: module is not defined in ES module scope după ce afișează rezultatele. Schimbă exportul în sintaxa modulelor ES, ca programul să ruleze până la capăt.

Codul care dă eroarea
JavaScript
import path from "path";

function numeFaraExtensie(fisier) {
  return path.parse(fisier).name;
}

function extensie(fisier) {
  return path.extname(fisier).slice(1);
}

console.log(numeFaraExtensie("raport-iunie.pdf"));
console.log(extensie("raport-iunie.pdf"));

module.exports = { numeFaraExtensie, extensie };
După reparație, programul afișează
raport-iunie
pdf
Indiciu

module.exports = { a, b }; se scrie în modulele ES export { a, b };.

Alte forme ale mesajului

  • ReferenceError: exports is not defined in ES module scope
  • ReferenceError: module is not defined

Cum o eviți pe viitor

  • Când treci un proiect pe import, schimbă în același timp și exporturile: module.exports devine export.
  • Caută în proiect module.exports și exports. după ce pui "type": "module".
  • Dacă un fișier trebuie să rămână CommonJS, redenumește-l .cjs.
  • Lasă editorul sau un linter (ESLint) să-ți arate folosirea lui module în fișierele ES.

Întrebări frecvente

Pot avea și export și module.exports în același fișier?

Nu. Un fișier e fie modul ES, fie CommonJS. Alege un stil pentru tot fișierul.

Cum import un export implicit?

Fără acolade: import formatLei from "./preturi.js". Exporturile cu nume se importă cu acolade: import { TVA } from "./preturi.js".

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.