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

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

Pe scurt

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

Greșit
JavaScript
// package.json
{ "type": "module" }

// index.js
import { formatLei } from "#utils/format.js";
Corect
JavaScript
// 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

Greșit
JavaScript
// tsconfig.json
"paths": { "#utils/*": ["./src/utils/*"] }
Corect
JavaScript
// 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ă

Greșit
JavaScript
import { formatLei } from "#utils/format.js";
Corect
JavaScript
import { formatLei } from "./utils/format.js";

Calea relativă nu are nevoie de nicio configurare: e cea mai simplă variantă într-un proiect mic.

Repară tu

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.

Codul care dă eroarea
JavaScript
import { formatLei } from "#utils/format.js";

console.log(formatLei(49.9));
console.log(formatLei(1200));
După reparație, programul afișează
49.90 lei
1200.00 lei
Indiciu

Fișierul există în utils/format.js: importă-l cu o cale relativă care începe cu ./.

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.js
  • Error [ERR_PACKAGE_IMPORT_NOT_DEFINED]: Package import specifier "#db" is not defined imported from /app/src/index.js
  • TypeError [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 în imports din package.json și verifică numele identic.
  • Folosește modelul cu * ("#utils/*": "./utils/*") ca să nu adaugi fiecare fișier separat.
  • În TypeScript, păstrează paths și imports sincronizate sau folosește doar imports (TypeScript îl înțelege cu moduleResolution: "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

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