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

Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:'

Pe scurt

Ai dat lui import() o cale absolută Windows (C:\proiect\...), iar modulele ES o citesc ca URL cu protocolul "c:". Transformă calea în URL file:// cu pathToFileURL(cale).href din node:url înainte de import.

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

Ce înseamnă

Modulele ES identifică fișierele prin URL-uri, nu prin căi de disc. Un specificator care începe cu litera: e interpretat ca URL cu acel protocol: C:\proiect\pluginuri\tva.js devine un URL cu protocolul c:, pe care încărcătorul nu îl cunoaște. Sunt acceptate doar file:, data: și node:.

Pe Linux și macOS problema nu se vede, pentru că o cale absolută (/home/ana/proiect/tva.js) începe cu / și e tratată ca adresă relativă la URL-ul curent. De aceea codul merge pe serverul de producție și pică pe laptopul cu Windows al unui coleg, sau invers.

Apare la import() dinamic cu o cale construită de path.resolve / path.join, la încărcarea pluginurilor sau a fișierelor de configurare după cale, și în unele unelte (ESLint, Jest, scripturi proprii) care primesc căi absolute. Mesajul îți spune protocolul primit ('c:', 'd:'); dacă vezi altceva, de exemplu 'https:', înseamnă că încerci să imporți direct de pe internet, ceea ce Node nu face implicit.

De ce apare: cauzele frecvente

1Cale absolută Windows trimisă direct în import()

Greșit
JavaScript
const fisier = path.resolve("pluginuri", "tva.js");
const plugin = await import(fisier);
Corect
JavaScript
import { pathToFileURL } from "node:url";
const fisier = path.resolve("pluginuri", "tva.js");
const plugin = await import(pathToFileURL(fisier).href);

pathToFileURL transformă orice cale de disc într-un URL file:///C:/proiect/..., valid pe toate sistemele de operare.

2Calea vine dintr-un fișier de configurare

Greșit
JavaScript
// config.json: { "plugin": "C:\\proiect\\tva.js" }
await import(config.plugin);
Corect
JavaScript
await import(pathToFileURL(path.resolve(config.plugin)).href);

Orice cale de disc care ajunge într-un import() trebuie convertită; nu presupune că vine deja ca URL.

3Import de pe internet

Greșit
JavaScript
await import("https://cdn.exemplu.ro/lib.js");
Corect
JavaScript
// instalează pachetul cu npm și importă-l după nume
import lib from "lib";

Încărcătorul implicit al lui Node nu descarcă module prin https:; dependențele se instalează local.

Repară tu

Repară eroarea, direct în pagină

Programul încarcă un plugin cu import(). Codul simulează ce se întâmplă pe Windows, unde calea absolută arată ca C:\proiect\pluginuri\tva.js, și dă Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]. Construiește calea cu path.resolve și transform-o în URL file://, ca pluginul să se încarce pe orice sistem și programul să afișeze prețul cu TVA.

Codul care dă eroarea
JavaScript
import path from "node:path";

// Pe Windows, calea absolută a pluginului arată așa:
const fisier = path.win32.join("C:\\proiect", "pluginuri", "tva.js");
const plugin = await import(fisier);

console.log(`Plugin: ${plugin.nume}`);
console.log(`100 lei fără TVA = ${plugin.calculeaza(100).toFixed(2)} lei`);
După reparație, programul afișează
Plugin: TVA 21%
100 lei fără TVA = 121.00 lei
Indiciu

Importă pathToFileURL din node:url și dă lui import() valoarea pathToFileURL(fisier).href.

Alte forme ale mesajului

  • Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. Received protocol 'c:'
  • Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'd:'
  • Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only URLs with a scheme in: file, data, and node are supported by the default ESM loader. Received protocol 'https:'
  • Error [ERR_UNSUPPORTED_ESM_URL_SCHEME]: Only file and data URLs are supported by the default ESM loader. On Windows, absolute paths must be valid file:// URLs. Received protocol 'c:'

Cum o eviți pe viitor

  • Trece orice cale construită cu path prin pathToFileURL(...).href înainte de import().
  • Pentru fișierele din proiect, poți porni și direct de la URL: new URL("./pluginuri/tva.js", import.meta.url).
  • Rulează testele și pe Windows (de exemplu în CI), ca să prinzi diferențele de căi devreme.

Întrebări frecvente

De ce merge pe Mac și pică pe Windows?

Pe Mac calea absolută începe cu /, care e acceptat ca adresă relativă. Pe Windows începe cu litera discului și două puncte, ceea ce pentru un URL înseamnă protocol.

Și require() are aceeași problemă?

Nu. require lucrează cu căi de disc și acceptă C:\... fără probleme. Conversia e necesară doar pentru import și import().

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.