SyntaxError: The requested module './utils/index.js' contains conflicting star exports for name 'formateaza'
Fișierul index reexportă cu export * două module care au amândouă un export cu același nume, deci Node nu știe pe care să ți-l dea. Importă numele direct din modulul dorit sau reexportă-l explicit, cu redenumire: export { formateaza as formateazaLei } from "./bani.js".
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
export * from "./bani.js" reexportă toate exporturile cu nume ale modulului. Dacă două instrucțiuni export * din același fișier aduc același nume, numele devine ambiguu: specificația spune că el pur și simplu nu e exportat, iar importul lui explicit e o eroare.
Mesajul îți spune modulul care face reexportul (./utils/index.js) și numele în conflict (formateaza). Celelalte nume din același fișier funcționează normal; problema apare doar când ceri numele ambiguu.
Situația e tipică pentru fișierele „barrel” (un index.js care adună exporturile unui dosar), când două module ajung, independent, să aibă o funcție cu același nume: formateaza, valideaza, config. Eroarea apare la încărcarea modulelor, înainte să ruleze vreo linie din program, de aceea nu o poți prinde cu try/catch.
De ce apare: cauzele frecvente
1Două module cu același nume reexportate cu export *
// utils/index.js
export * from "./bani.js";
export * from "./text.js";// utils/index.js
export { formateaza as formateazaLei } from "./bani.js";
export { formateaza as formateazaText, majuscule } from "./text.js";Reexporturile explicite cu redenumire dau fiecărei funcții un nume unic, deci nu mai există ambiguitate.
2Importul numelui ambiguu prin index
import { formateaza } from "./utils/index.js";import { formateaza } from "./utils/bani.js";Importat direct din modulul care îl definește, numele e unic și clar.
3Constantă comună definită de două ori
// a.js și b.js
export const VERSIUNE = "1.0";// constante.js
export const VERSIUNE = "1.0";
// a.js și b.js o importă de aici, fără s-o reexporteO valoare comună definită într-un singur loc nu mai ajunge de două ori în barrel.
Repară eroarea, direct în pagină
Fișierul utils/index.js reexportă cu export * modulele bani.js și text.js, care au amândouă o funcție formateaza. Importul din index.js dă SyntaxError: ... contains conflicting star exports for name 'formateaza'. Importă formateaza direct din bani.js (păstrează majuscule din index), ca programul să afișeze produsele cu prețurile formatate.
import { formateaza, majuscule } from "./utils/index.js";
const produse = [
{ nume: "cafea", pret: 42 },
{ nume: "ceai", pret: 18.5 },
];
for (const p of produse) {
console.log(`${majuscule(p.nume)} - ${formateaza(p.pret)}`);
}CAFEA - 42.00 lei CEAI - 18.50 lei
Indiciu
Fă două importuri: formateaza din ./utils/bani.js și majuscule din ./utils/index.js.
Reparația
import { formateaza } from "./utils/bani.js";
import { majuscule } from "./utils/index.js";
const produse = [
{ nume: "cafea", pret: 42 },
{ nume: "ceai", pret: 18.5 },
];
for (const p of produse) {
console.log(`${majuscule(p.nume)} - ${formateaza(p.pret)}`);
}De ce merge
Cele două export * aduc în utils/index.js două funcții numite formateaza, iar numele devine ambiguu și nu mai e exportat de acolo. Importul direct din ./utils/bani.js cere o singură funcție, fără ambiguitate. majuscule există într-un singur modul, deci poate veni în continuare prin index. Reparația de durată ar fi redenumirea uneia dintre funcții sau reexporturi explicite în index.js.
Alte forme ale mesajului
SyntaxError: The requested module './index.js' contains conflicting star exports for name 'config'SyntaxError: The requested module '../utils/index.js' contains conflicting star exports for name 'valideaza'SyntaxError: Detected cycle while resolving name 'formateaza' in './utils/index.js'
Cum o eviți pe viitor
- În fișierele index, preferă reexporturile explicite (
export { a, b } from "./x.js") în locul luiexport *. - Dă funcțiilor nume specifice (
formateazaLei,formateazaData), nu generice. - Pentru dosarele mari, importă direct din fișierul care definește funcția; barrel-urile mari încetinesc și încărcarea.
Întrebări frecvente
De ce celelalte importuri din index merg?
Doar numele aflat în conflict e eliminat din exporturi. Restul numelor aduse de export * rămân disponibile.
Care dintre cele două funcții ar trebui să câștige?
Niciuna: specificația modulelor ES nu alege. Tu trebuie să spui explicit ce vrei, prin redenumire sau import direct.
Erori înrudite
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. SyntaxError: Duplicate export of 'default' Un modul ES poate avea un singur export default, iar tu ai două (sau același nume exportat de două ori). Păstrează un singur export default și exportă restul cu nume: export { totalCos }. SyntaxError: Export 'formatLei' is not defined in module În export { formatLei } ai pus un nume care nu există în fișier: funcția sau variabila are alt nume, a fost ștearsă ori e definită în alt modul. Exportă numele real (export { formateazaLei }) sau redenumește la export: export { formateazaLei as formatLei }. Î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.
