...
Eroare Node.js · Server HTTP, fetch și porturi

TypeError: Invalid URL

Pe scurt

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.

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

Ce înseamnă

Constructorul URL acceptă doar adrese absolute, cu protocol și (de obicei) domeniu: http://localhost:3000/produse?pagina=2. Un text ca /produse?pagina=2, localhost:3000 fără http:// sau un șir gol nu e URL valid, iar Node aruncă TypeError: Invalid URL, cu code: 'ERR_INVALID_URL' și input: '...', textul care a cauzat problema.

Cel mai des apare într-un server http: req.url conține doar calea și query string-ul, nu adresa completă. Ca să citești parametrii cu searchParams, construiești URL-ul cu o bază: new URL(req.url, "http://localhost"). Baza contează doar pentru rezolvare; poate fi orice adresă validă.

Alte cauze: adrese citite din configurație fără protocol, spații sau caractere invizibile la începutul textului, undefined transformat în text.

De ce apare: cauzele frecvente

1req.url fără bază

Greșit
JavaScript
const url = new URL(req.url);
const pagina = url.searchParams.get("pagina");
Corect
JavaScript
const url = new URL(req.url, "http://localhost");
const pagina = url.searchParams.get("pagina");

req.url e relativ (/produse?pagina=2); baza îl transformă într-o adresă completă.

2Adresă fără protocol în configurație

Greșit
JavaScript
const api = new URL("api.exemplu.ro/v1/produse");
Corect
JavaScript
const api = new URL("https://api.exemplu.ro/v1/produse");

Fără https://, textul nu are protocol și nu poate fi interpretat ca adresă.

3Cale de fișier în loc de URL

Greșit
JavaScript
fileURLToPath(import.meta.dirname);
Corect
JavaScript
const dosar = import.meta.dirname; // e deja o cale

import.meta.dirname și __dirname sunt căi de pe disc, nu URL-uri; nu le mai treci prin funcții care așteaptă URL.

Repară tu

Repară eroarea, direct în pagină

Serverul calculează prețul cu TVA din parametrul suma al adresei, dar construiește URL-ul din req.url fără bază, așa că la prima cerere se oprește cu TypeError: Invalid URL. Dă-i lui new URL o bază, ca testul să afișeze răspunsurile pentru ambele cereri.

Codul care dă eroarea
JavaScript
const http = require("http");

const server = http.createServer((req, res) => {
  const url = new URL(req.url);
  const suma = Number(url.searchParams.get("suma"));
  res.end(`${url.pathname}: ${(suma * 1.21).toFixed(2)} lei`);
});

server.listen(3000, async () => {
  for (const cale of ["/pret?suma=100", "/pret?suma=20"]) {
    const r = await fetch(`http://localhost:3000${cale}`);
    console.log(`${r.status} ${await r.text()}`);
  }
  server.close();
});
După reparație, programul afișează
200 /pret: 121.00 lei
200 /pret: 24.20 lei
Indiciu

new URL(req.url, "http://localhost").

Alte forme ale mesajului

  • TypeError [ERR_INVALID_URL]: Invalid URL
  • TypeError: Invalid URL code: 'ERR_INVALID_URL', input: '/produse?pagina=2'
  • TypeError: Failed to construct 'URL': Invalid URL

Cum o eviți pe viitor

  • În serverele http, construiește URL-ul cererii mereu cu bază: new URL(req.url, http://${req.headers.host}) sau "http://localhost".
  • Păstrează adresele din configurație complete, cu https://.
  • Afișează err.input când prinzi eroarea: îți arată textul exact.
  • Pentru validarea adreselor de la utilizatori, folosește URL.canParse(text) (Node 19.9+) înainte de new URL.

Întrebări frecvente

Ce bază să pun pentru req.url?

Orice adresă validă, de exemplu "http://localhost", dacă îți trebuie doar calea și parametrii. Dacă ai nevoie și de domeniul real, folosește ` http://${req.headers.host} `.

url.parse(req.url) mergea fără bază. De ce nu-l folosesc?

url.parse e un API vechi, marcat ca depreciat, care acceptă și adrese invalide și le interpretează uneori greșit. new URL e standardul, același ca în browser.

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.