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

SyntaxError: The requested module './utils/index.js' contains conflicting star exports for name 'formateaza'

Pe scurt

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 *

Greșit
JavaScript
// utils/index.js
export * from "./bani.js";
export * from "./text.js";
Corect
JavaScript
// 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

Greșit
JavaScript
import { formateaza } from "./utils/index.js";
Corect
JavaScript
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

Greșit
JavaScript
// a.js și b.js
export const VERSIUNE = "1.0";
Corect
JavaScript
// constante.js
export const VERSIUNE = "1.0";
// a.js și b.js o importă de aici, fără s-o reexporte

O valoare comună definită într-un singur loc nu mai ajunge de două ori în barrel.

Repară tu

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.

Codul care dă eroarea
JavaScript
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)}`);
}
După reparație, programul afișează
CAFEA - 42.00 lei
CEAI - 18.50 lei
Indiciu

Fă două importuri: formateaza din ./utils/bani.js și majuscule din ./utils/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 lui export *.
  • 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

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