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

Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/utils' is not supported resolving ES modules imported from /app/index.js

Pe scurt

Î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".

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

Ce înseamnă

În CommonJS, require("./utils") caută automat utils.js, utils/index.js sau main din utils/package.json. Modulele ES nu mai fac asta: specificatorul e tratat ca o adresă exactă, iar ./utils indică un dosar, nu un fișier. Node refuză și îți spune ce a încercat să încarce (Directory import '/app/utils') și din ce fișier (imported from /app/index.js).

Node 22+ adaugă de obicei și o sugestie: Did you mean to import "./utils/index.js"?. De cele mai multe ori e exact reparația.

Eroarea apare des când treci un proiect de pe CommonJS pe "type": "module", când copiezi importuri dintr-un proiect cu bundler (Vite, webpack și TypeScript pot rezolva dosare, Node nu), sau la importul unui subdosar al unui pachet care nu are "exports", de exemplu pachet/locale.

De ce apare: cauzele frecvente

1Import de dosar în loc de fișier

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

Modulele ES cer calea exactă, cu numele fișierului și extensia.

2Cod scris pentru un bundler, rulat direct cu Node

Greșit
JavaScript
// merge în Vite, pică în Node
import { api } from "./servicii";
Corect
JavaScript
import { api } from "./servicii/index.js";

Bundler-ele au reguli proprii de rezolvare. Codul rulat direct cu Node trebuie să respecte regulile lui.

3Subdosar al unui pachet fără exports

Greșit
JavaScript
import ro from "pachet/locale/ro";
Corect
JavaScript
import ro from "pachet/locale/ro/index.js";

Dacă pachetul nu declară căile în "exports", Node nu completează index.js pentru tine; scrie calea completă sau caută în documentație importul recomandat.

Repară tu

Repară eroarea, direct în pagină

Proiectul folosește module ES ("type": "module"), iar index.js dă Error [ERR_UNSUPPORTED_DIR_IMPORT], pentru că importă dosarul ./utils. Corectează importul, ca programul să afișeze numele produselor cu majuscule și prețurile formatate.

Codul care dă eroarea
JavaScript
import { formatLei, majuscule } from "./utils";

const produse = [
  { nume: "cafea boabe", pret: 42 },
  { nume: "ceai verde", pret: 18.5 },
];

for (const p of produse) {
  console.log(`${majuscule(p.nume)}: ${formatLei(p.pret)}`);
}
După reparație, programul afișează
CAFEA BOABE: 42.00 lei
CEAI VERDE: 18.50 lei
Indiciu

Funcțiile sunt în fișierul utils/index.js; scrie calea completă, cu extensia.

Alte forme ale mesajului

  • Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/utils' is not supported resolving ES modules imported from /app/index.js Did you mean to import "./utils/index.js"?
  • Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/node_modules/pachet/locale' is not supported resolving ES modules imported from /app/index.js
  • Error [ERR_UNSUPPORTED_DIR_IMPORT]: Directory import '/app/src/routes' is not supported resolving ES modules imported from /app/src/server.js

Cum o eviți pe viitor

  • În modulele ES scrie întotdeauna calea completă: ./utils/index.js, nu ./utils sau ./utils/index.
  • Pentru importuri scurte, definește aliasuri în package.json cu "imports", de exemplu "#utils": "./utils/index.js".
  • În TypeScript cu "module": "nodenext", compilatorul te obligă să scrii extensiile, deci prinzi problema înainte de rulare.

Întrebări frecvente

De ce require("./utils") mergea?

Algoritmul CommonJS încearcă mai multe variante: fișier cu .js, .json, dosar cu index.js. Modulele ES folosesc rezolvarea de tip URL, fără ghicit, ca să fie la fel ca în browser.

Există o opțiune care să reactiveze comportamentul vechi?

A existat --experimental-specifier-resolution=node, dar a fost eliminată în Node 19. Calea corectă e să scrii importurile complete.

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.