Warning: Accessing non-existent property 'formatLei' of module exports inside circular dependency
Două module se cer reciproc cu require (dependență circulară), iar unul citește un export al celuilalt înainte ca acesta să termine de rulat, deci primește undefined. Rupe ciclul: mută funcțiile comune într-un modul separat sau citește proprietatea abia în momentul în care o folosești.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul apare când a.js cere b.js, iar b.js cere înapoi a.js (direct sau prin alte module). Ca să nu intre într-o buclă infinită, Node îi dă lui b.js obiectul module.exports al lui a.js așa cum e în acel moment: incomplet, pentru că a.js s-a oprit la linia cu require și n-a ajuns încă la exporturi.
Dacă b.js citește imediat o proprietate din acest obiect (de obicei prin destructurare: const { formatLei } = require("./a")), primește undefined. Node observă că proprietatea nu există în exporturile unui modul aflat într-un ciclu și afișează acest warning, cu numele proprietății.
Warning-ul nu oprește programul, dar de obicei urmează imediat TypeError: formatLei is not a function, când funcția e chiar apelată. Ca să afli unde se închide ciclul, rulează node --trace-warnings index.js: stiva arată lanțul de require. Ordinea în care modulele sunt încărcate prima dată decide cine primește exporturile incomplete, de aceea eroarea apare uneori doar după ce schimbi ordinea importurilor.
De ce apare: cauzele frecvente
1Două module care se cer unul pe altul
// cos.js
const { formatLei } = require("./format");
// format.js
const cos = require("./cos");// lei.js (fără alte require-uri)
exports.formatLei = (s) => `${s.toFixed(2)} lei`;
// cos.js și format.js
const { formatLei } = require("./lei");Funcția de care au nevoie amândouă stă acum într-un modul care nu cere nimic înapoi, deci ciclul dispare și fiecare modul primește exporturi complete.
2Destructurare la începutul fișierului
const { totalCos } = require("./cos");
function formatBon(p) {
return totalCos(p);
}const cos = require("./cos");
function formatBon(p) {
return cos.totalCos(p);
}Destructurarea copiază valoarea din acel moment (undefined). Păstrând obiectul și citind cos.totalCos abia la apel, găsești funcția, cu condiția ca cos.js să adauge proprietăți pe exports, nu să înlocuiască tot obiectul.
3Fișierul index (barrel) cerut înapoi din propriile module
// utils/index.js
module.exports = { ...require("./bani"), ...require("./text") };
// utils/text.js
const { formatLei } = require("./index");// utils/text.js
const { formatLei } = require("./bani");Un modul din interiorul unui dosar nu trebuie să ceară index.js-ul dosarului, care îl cere la rândul lui. Cere direct fișierul de care are nevoie.
Repară eroarea, direct în pagină
Modulele cos.js și format.js se cer reciproc, iar programul dă Warning: Accessing non-existent property 'formatLei' of module exports inside circular dependency, urmat de TypeError. Nu poți modifica acum cele două module. Schimbă în index.js ordinea în care le încarci, ca ciclul să se închidă fără exporturi lipsă și programul să afișeze totalul și bonul.
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
process.exitCode = 1;
});
const { formatBon } = require("./format");
const { afiseazaTotal } = require("./cos");
const produse = [
{ nume: "Cafea", pret: 42, cantitate: 2 },
{ nume: "Cană", pret: 35.5, cantitate: 1 },
];
try {
console.log(afiseazaTotal(produse));
console.log(formatBon(produse));
} catch (e) {
console.error(`Eroare: ${e.message}`);
process.exitCode = 1;
}Total coș: 119.50 lei Bon fiscal: 2 produse, 119.50 lei
Indiciu
format.js nu citește nimic din cos la încărcare, dar cos.js destructurează imediat formatLei. Care dintre ele trebuie încărcat primul?
Reparația
// Proiectul tratează orice warning ca pe o eroare (ca în CI): îl afișează și oprește cu cod 1.
process.on("warning", (w) => {
console.error(`${w.code ? `[${w.code}] ` : ""}${w.name}: ${w.message}`);
process.exitCode = 1;
});
const { afiseazaTotal } = require("./cos");
const { formatBon } = require("./format");
const produse = [
{ nume: "Cafea", pret: 42, cantitate: 2 },
{ nume: "Cană", pret: 35.5, cantitate: 1 },
];
try {
console.log(afiseazaTotal(produse));
console.log(formatBon(produse));
} catch (e) {
console.error(`Eroare: ${e.message}`);
process.exitCode = 1;
}De ce merge
Când index.js cere întâi format.js, acesta cere cos.js, care cere înapoi format.js și primește exporturile lui încă goale: destructurarea dă formatLei = undefined. Încărcând întâi cos.js, ciclul se închide în format.js, care doar păstrează obiectul cos și îl citește abia la apel, când totalCos există deja. Soluția durabilă rămâne ruperea ciclului: formatLei ar trebui mutată într-un modul fără alte dependențe.
Alte forme ale mesajului
Warning: Accessing non-existent property 'totalCos' of module exports inside circular dependency(node:4120) Warning: Accessing non-existent property 'config' of module exports inside circular dependency (Use `node --trace-warnings ...` to show where the warning was created)Warning: Accessing non-existent property 'default' of module exports inside circular dependency
Cum o eviți pe viitor
- Desenează (sau măcar gândește) dependențele: modulele de bază (formatare, configurare, constante) nu cer niciodată modulele de nivel mai înalt.
- Pune funcțiile folosite din mai multe locuri într-un modul propriu, fără alte
require-uri. - Nu cere
index.js-ul unui dosar din fișierele aceluiași dosar. - Tratează warning-ul ca pe o eroare: rulează cu
--trace-warningsși repară ciclul imediat. - Unelte ca
madge --circulargăsesc automat ciclurile dintr-un proiect.
Întrebări frecvente
De ce mergea până am schimbat ordinea require-urilor?
Modulul încărcat primul ajunge să ruleze complet abia la final, după ce celălalt modul l-a citit pe jumătate. Schimbând ordinea, schimbi cine primește exporturile incomplete. Ciclul exista și înainte, doar că nu se citea nimic lipsă.
Pot ignora warning-ul dacă programul pare să meargă?
Nu e recomandat. Înseamnă că un modul a citit o valoare undefined. Dacă azi nu o folosește, mâine o refactorizare mică o va face să pice cu is not a function.
Se întâmplă și cu import/export?
Ciclurile există și în modulele ES, dar acolo importurile sunt legături vii, nu copii. De obicei primești ReferenceError: Cannot access 'x' before initialization dacă folosești valoarea prea devreme.
Erori înrudite
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. Error: Cannot find module './calcul' Node nu găsește fișierul pe care îl ceri cu require: calea e scrisă greșit, fișierul are alt nume sau e în alt dosar. Verifică numele exact al fișierului și calea relativă față de fișierul care face require, de exemplu require("./calcule") sau require("./lib/calcule"). TypeError: Class extends value #<Object> is not a constructor or null Clasa de după extends nu este o clasă, ci un obiect: de obicei modulul exportă { Produs }, iar tu scrii const Produs = require("./produs"). Ia clasa din obiect cu const { Produs } = require("./produs") sau exportă direct clasa cu module.exports = Produs. Î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.
