Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './lib/format.js' is not defined by "exports" in /app/node_modules/preturi/package.json
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
const { formatLei } = require("preturi/lib/format.js");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
const { v4 } = require("uuid/v4");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
const { version } = require("pachet/package.json");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ă 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.
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))}`);
}Cafea: 48.40 lei Ceai: 21.78 lei
Indiciu
"exports" are doar cheia ".", adică pachetul se importă numai după nume: require("preturi").
Reparația
const { formatLei, cotaTva } = require("preturi");
const produse = [
{ nume: "Cafea", pret: 40 },
{ nume: "Ceai", pret: 18 },
];
for (const p of produse) {
console.log(`${p.nume}: ${formatLei(p.pret * (1 + cotaTva))}`);
}De ce merge
Pachetul preturi declară în "exports" o singură intrare publică, ".", adică importul după nume. Orice altă cale, chiar dacă fișierul există, e respinsă cu ERR_PACKAGE_PATH_NOT_EXPORTED. Intrarea principală reexportă formatLei și oferă și cotaTva, deci require("preturi") îți dă tot ce îți trebuie, iar codul tău nu mai depinde de structura internă a pachetului.
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.jsError [ERR_PACKAGE_PATH_NOT_EXPORTED]: No "exports" main defined in /app/node_modules/pachet/package.jsonError [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './package.json' is not defined by "exports" in /app/node_modules/pachet/package.jsonError [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"dinpackage.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
Error: Cannot find module 'lodash' Pachetul cerut nu este instalat în node_modules: ai uitat npm install, l-ai instalat în alt dosar sau numele e scris greșit. Rulează npm install lodash (sau npm install dacă e deja în package.json) în dosarul proiectului, ori folosește o funcție inclusă în Node. Error [ERR_MODULE_NOT_FOUND]: Cannot find module '/app/utils/preturi.js' imported from /app/index.js Un import dintr-un modul ES arată spre un fișier care nu există: calea e greșită sau lipsește extensia. În modulele ES extensia este obligatorie: import x from "./preturi.js", nu "./preturi". Verifică dosarul și numele fișierului. Error [ERR_REQUIRE_ESM]: require() of ES Module /app/node_modules/chalk/source/index.js from /app/index.js not supported. Încerci să încarci cu require un modul care e scris ca modul ES (multe pachete noi, ca chalk 5 sau node-fetch 3, sunt doar ESM). Folosește import în loc de require, un import() dinamic, sau o versiune mai veche a pachetului care are CommonJS. Î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.
