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

TypeError [ERR_INVALID_URL_SCHEME]: The URL must be of scheme file

Pe scurt

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

Greșit
JavaScript
import { fileURLToPath } from "node:url";
fileURLToPath("https://cdn.exemplu.ro/poze/logo.png");
Corect
JavaScript
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

Greșit
JavaScript
function numeFisier(sursa) {
  return path.basename(fileURLToPath(sursa));
}
Corect
JavaScript
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

Greșit
JavaScript
fileURLToPath("./date/produse.json");
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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));
}
După reparație, programul afișează
produse.json
logo.png
iunie.csv
Indiciu

Construiește const url = new URL(sursa) și verifică url.protocol === "file:".

Alte forme ale mesajului

  • TypeError [ERR_INVALID_URL]: Invalid URL
  • TypeError [ERR_INVALID_FILE_URL_HOST]: File URL host must be "localhost" or empty on linux

Cum o eviți pe viitor

  • Folosește fileURLToPath doar pentru import.meta.url și pentru URL-uri create cu new 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 și import.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

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