...
Eroare Node.js · Module CommonJS: require și module.exports

Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './lib/format.js' is not defined by "exports" in /app/node_modules/preturi/package.json

Pe scurt

Pachetul are câmpul "exports" în package.json, care spune exact ce căi au voie să fie importate, iar calea ta internă (de exemplu pachet/lib/format.js) nu e în listă. Importă pachetul prin calea publică (de obicei doar numele lui) sau printr-o cale listată în "exports".

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

Ce înseamnă

Câmpul "exports" din package.json-ul unui pachet funcționează ca o listă de intrări permise. Dacă există, Node refuză orice import care nu e în listă, chiar dacă fișierul există pe disc. Astfel autorii pachetului își pot reorganiza fișierele interne fără să strice codul celor care îl folosesc.

Mesajul îți spune exact ce s-a cerut (Package subpath './lib/format.js') și unde e lista (package.json-ul pachetului din node_modules). Deschide acel fișier și uită-te la cheile din "exports": acelea sunt căile pe care le poți folosi.

Eroarea apare des după actualizarea unui pachet la o versiune majoră nouă (care a introdus "exports"), când urmezi un tutorial vechi care importa fișiere interne, sau la require("pachet/package.json") pentru a citi versiunea. Varianta No "exports" main defined înseamnă că pachetul nu exportă deloc intrarea principală pentru felul în care îl încarci (de exemplu are doar "import", iar tu folosești require).

De ce apare: cauzele frecvente

1Import dintr-un fișier intern al pachetului

Greșit
JavaScript
const { formatLei } = require("preturi/lib/format.js");
Corect
JavaScript
const { formatLei } = require("preturi");

Doar intrările din "exports" sunt publice. Intrarea principală (".") oferă de obicei tot ce ai nevoie.

2Cale veche după actualizarea pachetului

Greșit
JavaScript
const { v4 } = require("uuid/v4");
Corect
JavaScript
const { v4 } = require("uuid");

Versiunile noi au restrâns căile publice. Changelog-ul pachetului spune care e noul mod de import.

3Citirea package.json-ului unui pachet

Greșit
JavaScript
const { version } = require("pachet/package.json");
Corect
JavaScript
const fs = require("fs");
const fisier = require.resolve("pachet").replace(/index\.js$/, "package.json");
const { version } = JSON.parse(fs.readFileSync(fisier, "utf8"));

Dacă "./package.json" nu e în "exports", nu îl poți cere direct; îl citești ca fișier obișnuit pornind de la calea rezolvată a pachetului.

Repară tu

Repară eroarea, direct în pagină

Programul folosește pachetul preturi din node_modules și dă Error [ERR_PACKAGE_PATH_NOT_EXPORTED], pentru că importă direct fișierul intern lib/format.js, care nu e în "exports". Importă formatLei și cotaTva prin intrarea publică a pachetului, ca programul să afișeze prețurile cu TVA.

Codul care dă eroarea
JavaScript
const { formatLei } = require("preturi/lib/format.js");
const cotaTva = 0.21;

const produse = [
  { nume: "Cafea", pret: 40 },
  { nume: "Ceai", pret: 18 },
];

for (const p of produse) {
  console.log(`${p.nume}: ${formatLei(p.pret * (1 + cotaTva))}`);
}
După reparație, programul afișează
Cafea: 48.40 lei
Ceai: 21.78 lei
Indiciu

"exports" are doar cheia ".", adică pachetul se importă numai după nume: require("preturi").

Alte forme ale mesajului

  • Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './lib/format.js' is not defined by "exports" in /app/node_modules/preturi/package.json imported from /app/index.js
  • Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in /app/node_modules/pachet/package.json
  • Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './package.json' is not defined by "exports" in /app/node_modules/pachet/package.json
  • Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './v4' is not defined by "exports" in /app/node_modules/uuid/package.json

Cum o eviți pe viitor

  • Importă pachetele doar prin căile din documentația lor, nu prin fișiere găsite în node_modules.
  • Înainte de o actualizare majoră, citește secțiunea „breaking changes”; schimbarea căilor de import e frecventă.
  • Când ai nevoie de ceva intern, deschide "exports" din package.json-ul pachetului și caută o intrare publică echivalentă.

Întrebări frecvente

Fișierul există în node_modules. De ce nu îl găsește?

Îl găsește, dar refuză să îl încarce. Cu "exports" definit, existența fișierului nu mai contează: contează doar dacă autorul l-a declarat public.

Pot modifica package.json-ul pachetului ca să meargă?

Tehnic da, dar modificarea dispare la următorul npm install. Mai bine folosești calea publică, alegi altă versiune a pachetului sau ceri autorului să expună intrarea.

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.