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:.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fileURLToPath din node:url are un singur rol: transformă un URL de fișier (file:///app/date/produse.json) în calea obișnuită de pe disc (/app/date/produse.json, sau C:\app\... pe Windows). Cel mai des îl vezi în modulele ES, în rețeta fileURLToPath(import.meta.url), care înlocuiește __filename.
Dacă primește un URL cu alt protocol (https:, http:, data:), nu are ce cale de pe disc să întoarcă, așa că aruncă ERR_INVALID_URL_SCHEME: URL-ul trebuie să fie de tip file.
Situații tipice: aceeași funcție primește atât fișiere locale, cât și adrese web; rulezi codul printr-un bundler sau un mediu în care import.meta.url nu e file:; sau transformi o adresă venită de la utilizator. Mesajul nu îți spune ce URL a primit, așa că afișează-l înainte de apel.
De ce apare: cauzele frecvente
1Adresă web dată lui fileURLToPath
import { fileURLToPath } from "node:url";
fileURLToPath("https://cdn.exemplu.ro/poze/logo.png");new URL("https://cdn.exemplu.ro/poze/logo.png").pathname;
// "/poze/logo.png"Pentru adresele web nu există cale pe disc; partea de cale a URL-ului o iei cu pathname.
2Funcție care primește ambele tipuri de surse
function numeFisier(sursa) {
return path.basename(fileURLToPath(sursa));
}function numeFisier(sursa) {
const url = new URL(sursa);
const cale = url.protocol === "file:" ? fileURLToPath(url) : url.pathname;
return path.basename(cale);
}Verifici întâi protocolul și alegi transformarea potrivită.
3URL relativ sau text simplu
fileURLToPath("./date/produse.json");fileURLToPath(new URL("./date/produse.json", import.meta.url));Un text fără protocol nu e URL. Îl construiești relativ la modulul curent cu new URL(cale, import.meta.url).
Repară eroarea, direct în pagină
Funcția numeFisier scoate numele fișierului dintr-o sursă, dar folosește fileURLToPath și pentru adresele web, așa că a doua sursă dă TypeError [ERR_INVALID_URL_SCHEME]: The URL must be of scheme file. Folosește fileURLToPath doar pentru URL-urile file:, iar pentru celelalte calea din url.pathname, ca programul să afișeze numele celor trei fișiere.
import { fileURLToPath } from "node:url";
import path from "node:path";
function numeFisier(sursa) {
return path.basename(fileURLToPath(sursa));
}
const surse = [
"file:///app/date/produse.json",
"https://cdn.exemplu.ro/poze/logo.png",
"file:///app/rapoarte/iunie.csv",
];
for (const sursa of surse) {
console.log(numeFisier(sursa));
}produse.json logo.png iunie.csv
Indiciu
Construiește const url = new URL(sursa) și verifică url.protocol === "file:".
Reparația
import { fileURLToPath } from "node:url";
import path from "node:path";
function numeFisier(sursa) {
const url = new URL(sursa);
const cale = url.protocol === "file:" ? fileURLToPath(url) : url.pathname;
return path.basename(cale);
}
const surse = [
"file:///app/date/produse.json",
"https://cdn.exemplu.ro/poze/logo.png",
"file:///app/rapoarte/iunie.csv",
];
for (const sursa of surse) {
console.log(numeFisier(sursa));
}De ce merge
fileURLToPath știe să transforme doar URL-uri file: în căi de pe disc, de aceea adresa https: producea eroarea. new URL(sursa) desface orice URL în bucăți, iar protocol îți spune ce fel de sursă ai. Pentru fișiere locale păstrezi fileURLToPath, iar pentru adresele web folosești pathname, adică partea de după domeniu. path.basename scoate apoi numele fișierului în ambele cazuri.
Alte forme ale mesajului
TypeError [ERR_INVALID_URL]: Invalid URLTypeError [ERR_INVALID_FILE_URL_HOST]: File URL host must be "localhost" or empty on linux
Cum o eviți pe viitor
- Folosește
fileURLToPathdoar pentruimport.meta.urlși pentru URL-uri create cunew URL(..., import.meta.url). - Când o funcție primește surse diferite, verifică
url.protocolînainte să alegi ce faci. - În Node 20.11+ poți folosi direct
import.meta.dirnameșiimport.meta.filename, fărăfileURLToPath. - Afișează URL-ul primit când depanezi: eroarea nu îl include.
Întrebări frecvente
Cum obțin __dirname într-un modul ES?
import.meta.dirname în Node 20.11 sau mai nou. În versiunile mai vechi: path.dirname(fileURLToPath(import.meta.url)).
Pot citi direct un fișier dintr-un URL file:?
Da, funcțiile din fs acceptă și obiecte URL cu protocolul file:: fs.readFileSync(new URL("./date.json", import.meta.url)).
Erori înrudite
ReferenceError: __dirname is not defined in ES module scope În modulele ES nu există __dirname și __filename. Folosește import.meta.dirname și import.meta.filename (Node 20.11+) sau calculează-le din import.meta.url cu fileURLToPath și path.dirname. 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. TypeError [ERR_INVALID_ARG_TYPE]: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined Ai dat unei funcții din fs sau path o cale care este undefined, nu un text. De obicei vine din process.argv[2] lipsă, o proprietate scrisă greșit sau o variabilă de mediu nesetată. Verifică variabila și pune o valoare implicită. Î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.
