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.
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
import path from "path";
function nume(f) { return path.parse(f).name; }
module.exports = { nume };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
module.exports = function formatLei(x) { return `${x} lei`; };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
exports.TVA = 0.19;export const TVA = 0.19;Și exports lipsește din modulele ES; folosești exporturi cu nume.
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.
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 };raport-iunie pdf
Indiciu
module.exports = { a, b }; se scrie în modulele ES export { a, b };.
Reparația
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"));
export { numeFaraExtensie, extensie };De ce merge
În modulele ES Node nu creează obiectul module, așa că module.exports nu are unde să scrie și aruncă ReferenceError. Rândurile de deasupra se afișează, pentru că eroarea apare abia când execuția ajunge la export. export { numeFaraExtensie, extensie } face cele două funcții disponibile pentru alte module, care le pot lua cu import { extensie } from "./fisier.js".
Alte forme ale mesajului
ReferenceError: exports is not defined in ES module scopeReferenceError: 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.exportsdevineexport. - Caută în proiect
module.exportsșiexports.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
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". SyntaxError: The requested module './preturi.js' does not provide an export named 'formatLei' Importi cu acolade un nume pe care modulul nu îl exportă cu acel nume. De obicei funcția e exportată implicit (export default) și trebuie importată fără acolade, sau numele e scris diferit. Verifică exporturile modulului. TypeError: calcule.totalCos is not a function Modulul nu exportă funcția pe care o apelezi, așa că require îți dă un obiect fără ea. Cauza clasică în Node: ai scris exports = { totalCos } în loc de module.exports = { totalCos }, ai uitat exportul sau numele diferă. Exportă cu module.exports. Î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.
