TypeError [ERR_PACKAGE_IMPORT_NOT_DEFINED]: Package import specifier "#utils/format.js" is not defined in package /app/package.json imported from /app/index.js
Un import care începe cu # (de exemplu "#utils/format.js") e un alias intern și trebuie declarat în câmpul "imports" din package.json. Adaugă aliasul acolo ("#utils/*": "./utils/*") sau folosește calea relativă obișnuită ("./utils/format.js").
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Specificatorii care încep cu # sunt subpath imports: alias-uri private ale pachetului, definite în câmpul imports din package.json. Node nu îi tratează ca pe niște căi și nici ca pe pachete din node_modules: îi caută doar în imports.
Mesajul spune: aliasul #utils/format.js nu e definit în /app/package.json (cel mai apropiat package.json de fișierul care face importul), iar importul a fost făcut din /app/index.js.
Apare de obicei când copiezi cod dintr-un proiect care avea alias-uri (#utils, #config, #db), dar nu și secțiunea imports, sau când alias-urile sunt definite doar pentru TypeScript (paths în tsconfig.json), pe care Node nu-l citește. Mai apare când aliasul există, dar cu alt nume (#util vs #utils) sau fără *.
De ce apare: cauzele frecvente
1Lipsește câmpul imports
// package.json
{ "type": "module" }
// index.js
import { formatLei } from "#utils/format.js";// package.json
{
"type": "module",
"imports": { "#utils/*": "./utils/*" }
}Cu "#utils/*": "./utils/*", Node înlocuiește * cu restul specificatorului și încarcă ./utils/format.js.
2Alias definit doar în tsconfig
// tsconfig.json
"paths": { "#utils/*": ["./src/utils/*"] }// package.json
"imports": { "#utils/*": "./dist/utils/*" }paths ajută doar compilatorul TypeScript. La rulare, Node citește doar imports din package.json.
3Ai nevoie doar de o cale relativă
import { formatLei } from "#utils/format.js";import { formatLei } from "./utils/format.js";Calea relativă nu are nevoie de nicio configurare: e cea mai simplă variantă într-un proiect mic.
Repară eroarea, direct în pagină
index.js importă funcția de formatare cu aliasul #utils/format.js, dar package.json-ul proiectului nu are câmpul imports, așa că Node oprește programul cu ERR_PACKAGE_IMPORT_NOT_DEFINED. Fără să modifici package.json, repară importul ca programul să afișeze cele două prețuri.
import { formatLei } from "#utils/format.js";
console.log(formatLei(49.9));
console.log(formatLei(1200));49.90 lei 1200.00 lei
Indiciu
Fișierul există în utils/format.js: importă-l cu o cale relativă care începe cu ./.
Reparația
import { formatLei } from "./utils/format.js";
console.log(formatLei(49.9));
console.log(formatLei(1200));De ce merge
Un specificator care începe cu # e căutat doar în câmpul imports din package.json; fără el, Node nu are de unde să știe ce fișier înseamnă #utils/format.js. Calea relativă ./utils/format.js indică direct fișierul, cu extensie, cum cer modulele ES. Varianta cu alias ar fi fost "imports": { "#utils/*": "./utils/*" } în package.json.
Alte forme ale mesajului
TypeError [ERR_PACKAGE_IMPORT_NOT_DEFINED]: Package import specifier "#config" is not defined in package /app/package.json imported from /app/server.jsError [ERR_PACKAGE_IMPORT_NOT_DEFINED]: Package import specifier "#db" is not defined imported from /app/src/index.jsTypeError [ERR_INVALID_MODULE_SPECIFIER]: Invalid module "#" is not a valid internal imports specifier name imported from /app/index.js
Cum o eviți pe viitor
- Când folosești alias-uri
#, definește-le înimportsdinpackage.jsonși verifică numele identic. - Folosește modelul cu
*("#utils/*": "./utils/*") ca să nu adaugi fiecare fișier separat. - În TypeScript, păstrează
pathsșiimportssincronizate sau folosește doarimports(TypeScript îl înțelege cumoduleResolution: "nodenext"). - Într-un proiect mic, căile relative sunt suficiente.
Întrebări frecvente
Merge aliasul și cu require?
Da. Câmpul imports funcționează și pentru require("#utils/format.js") în CommonJS, nu doar pentru import.
Pot folosi @ în loc de #, ca în Vite?
Nu în Node simplu. Alias-urile @/ din Vite sau webpack sunt rezolvate de bundler. Node acceptă alias-uri interne doar cu #, definite în imports.
Erori înrudite
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_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". Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/utils' is not supported resolving ES modules imported from /app/index.js În modulele ES nu poți importa un dosar (import ... from "./utils") și nici să lași Node să ghicească index.js. Scrie calea completă către fișier, cu extensie: import ... from "./utils/index.js". Î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.
