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.
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ă
const url = new URL(req.url);
const pagina = url.searchParams.get("pagina");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
const api = new URL("api.exemplu.ro/v1/produse");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
fileURLToPath(import.meta.dirname);const dosar = import.meta.dirname; // e deja o caleimport.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ă 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.
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();
});200 /pret: 121.00 lei 200 /pret: 24.20 lei
Indiciu
new URL(req.url, "http://localhost").
Reparația
const http = require("http");
const server = http.createServer((req, res) => {
const url = new URL(req.url, "http://localhost");
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();
});De ce merge
Pe server, req.url conține doar /pret?suma=100: calea și parametrii, fără protocol și domeniu. new URL acceptă singur doar adrese complete, de aceea arunca Invalid URL și oprea serverul. Cu baza "http://localhost", textul relativ e rezolvat la o adresă completă, iar searchParams.get("suma") îți dă parametrul.
Alte forme ale mesajului
TypeError [ERR_INVALID_URL]: Invalid URLTypeError: 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.inputcând prinzi eroarea: îți arată textul exact. - Pentru validarea adreselor de la utilizatori, folosește
URL.canParse(text)(Node 19.9+) înainte denew 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
TypeError: Failed to parse URL from /api/produse În Node, fetch() are nevoie de adresa completă, cu protocol și domeniu: fetch("http://localhost:3000/api/produse"). O cale relativă ("/api/produse") merge doar în browser, unde există pagina curentă ca bază. 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:. TypeError: parametri.hasOwnProperty is not a function Obiectul întors de querystring.parse() (și alte obiecte create cu Object.create(null)) nu are prototip, deci nu are metoda hasOwnProperty. Folosește Object.hasOwn(parametri, "cheie") sau "cheie" in parametri. Î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.
