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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fetch din Node (bazat pe biblioteca undici) transformă primul argument în URL. În browser, o adresă relativă ca /api/produse e completată automat cu adresa paginii curente. În Node nu există pagină curentă, deci nu există bază, iar /api/produse nu se poate transforma în URL: Failed to parse URL from /api/produse.
Sub mesaj, în cause, vezi eroarea de dedesubt: TypeError: Invalid URL cu input: '/api/produse'.
Apare când muți cod din frontend în Node (scripturi, teste, server-side rendering), când adresa de bază vine dintr-o variabilă de mediu goală (${process.env.API_URL}/produse devine undefined/produse) sau când lipsește http:// (localhost:3000/api).
De ce apare: cauzele frecvente
1Cale relativă copiată din frontend
const r = await fetch("/api/produse");const BAZA = "http://localhost:3000";
const r = await fetch(`${BAZA}/api/produse`);În Node scrii adresa completă; o constantă pentru bază te ajută să o schimbi ușor.
2Variabilă de mediu lipsă
fetch(`${process.env.API_URL}/produse`); // "undefined/produse"const API_URL = process.env.API_URL || "http://localhost:3000";
fetch(`${API_URL}/produse`);Cu o valoare implicită, adresa e completă și pe un calculator unde variabila nu e setată.
3Lipsește protocolul
fetch("localhost:3000/api/produse");fetch("http://localhost:3000/api/produse");Fără http://, localhost: e citit ca protocol, iar cererea nu poate fi trimisă.
Repară eroarea, direct în pagină
Programul pornește un server și apoi cere lista de produse, dar apelează fetch cu o cale relativă, ca în browser, și se oprește cu TypeError: Failed to parse URL from /api/produse. Folosește adresa completă a serverului, ca programul să afișeze produsele.
const http = require("http");
const produse = ["Cafea", "Ceai", "Cană"];
const server = http.createServer((req, res) => {
res.setHeader("Content-Type", "application/json");
res.end(JSON.stringify(produse));
});
server.listen(3000, async () => {
const r = await fetch("/api/produse");
const lista = await r.json();
console.log(`Status: ${r.status}`);
console.log(`Produse: ${lista.join(", ")}`);
server.close();
});Status: 200 Produse: Cafea, Ceai, Cană
Indiciu
Serverul ascultă pe http://localhost:3000.
Reparația
const http = require("http");
const produse = ["Cafea", "Ceai", "Cană"];
const server = http.createServer((req, res) => {
res.setHeader("Content-Type", "application/json");
res.end(JSON.stringify(produse));
});
server.listen(3000, async () => {
const r = await fetch("http://localhost:3000/api/produse");
const lista = await r.json();
console.log(`Status: ${r.status}`);
console.log(`Produse: ${lista.join(", ")}`);
server.close();
});De ce merge
În Node, fetch nu are o pagină curentă după care să completeze adresele relative, așa că /api/produse nu poate fi transformat în URL și cererea nici nu pleacă. Cu http://localhost:3000/api/produse, fetch știe protocolul, domeniul și portul, iar cererea ajunge la serverul pornit în același program.
Alte forme ale mesajului
TypeError: Failed to parse URL from undefined/produseTypeError: Failed to parse URL from /api/produse [cause]: TypeError: Invalid URLTypeError: fetch failed [cause]: Error: unknown schemeTypeError: Only absolute URLs are supported
Cum o eviți pe viitor
- Ține adresa de bază a API-ului într-o singură constantă sau variabilă de mediu, cu valoare implicită.
- Construiește adresele cu
new URL("/api/produse", BAZA): dă eroare clară dacă baza e invalidă. - Când refolosești cod între browser și Node, nu te baza pe adrese relative.
- În teste, pornește serverul pe un port cunoscut și construiește adresa din el.
Întrebări frecvente
De ce același cod merge în browser?
Browserul completează adresele relative cu adresa paginii curente (https://site.ro + /api/produse). În Node nu există o pagină curentă.
Ce e Only absolute URLs are supported?
Aceeași problemă, dar mesajul vine de la pachetul node-fetch, folosit înainte ca Node să aibă fetch inclus.
Erori înrudite
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. Error: connect ECONNREFUSED 127.0.0.1:3000 Programul tău încearcă să se conecteze la un server care nu ascultă la adresa și portul acela: serverul nu e pornit, s-a oprit sau folosești alt port. Pornește serverul (sau baza de date) și verifică portul din URL. Cu fetch, eroarea apare ca TypeError: fetch failed, cu ECONNREFUSED în cause. Error: getaddrinfo ENOTFOUND api.exemplu.ro Numele serverului din URL nu a putut fi găsit în DNS: e scris greșit (locahost, api.exmplu.ro), conține protocolul sau calea în locul greșit, ori nu ai conexiune la internet. Verifică numele de domeniu din URL sau din variabila de mediu. Cu fetch apare ca TypeError: fetch failed. Î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.
