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:'
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()
const fisier = path.resolve("pluginuri", "tva.js");
const plugin = await import(fisier);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
// config.json: { "plugin": "C:\\proiect\\tva.js" }
await import(config.plugin);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
await import("https://cdn.exemplu.ro/lib.js");// 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ă 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.
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`);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.
Reparația
import path from "node:path";
import { pathToFileURL } from "node:url";
const fisier = path.resolve("pluginuri", "tva.js");
const plugin = await import(pathToFileURL(fisier).href);
console.log(`Plugin: ${plugin.nume}`);
console.log(`100 lei fără TVA = ${plugin.calculeaza(100).toFixed(2)} lei`);De ce merge
import() primește un URL, nu o cale de disc. O cale Windows începe cu C:, pe care încărcătorul o citește ca protocol necunoscut. path.resolve construiește calea absolută potrivită sistemului pe care rulezi, iar pathToFileURL(...).href o transformă în file:///..., singura formă pe care încărcătorul o acceptă pentru fișiere locale. Același cod funcționează acum și pe Windows, și pe Linux.
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
pathprinpathToFileURL(...).hrefînainte deimport(). - 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
TypeError [ERR_INVALID_URL_SCHEME]: The URL must be of scheme file fileURLToPath() transformă doar adrese file:// în căi de pe disc, iar tu i-ai dat o adresă http(s):// sau alt tip de URL. Pentru adresele web folosește new URL(adresa).pathname; fileURLToPath păstrează-l pentru import.meta.url și alte URL-uri file:. 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. TypeError: Invalid URL new URL() a primit un text care nu e o adresă completă, de obicei o cale relativă ca req.url ("/produse?pagina=2"), fără protocol și domeniu. Dă-i și o bază: new URL(req.url, "http://localhost"). În eroare, câmpul input arată exact textul primit. Î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.
