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

TypeError: Failed to parse URL from /api/produse

Pe scurt

Î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

Greșit
JavaScript
const r = await fetch("/api/produse");
Corect
JavaScript
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ă

Greșit
JavaScript
fetch(`${process.env.API_URL}/produse`); // "undefined/produse"
Corect
JavaScript
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

Greșit
JavaScript
fetch("localhost:3000/api/produse");
Corect
JavaScript
fetch("http://localhost:3000/api/produse");

Fără http://, localhost: e citit ca protocol, iar cererea nu poate fi trimisă.

Repară tu

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.

Codul care dă eroarea
JavaScript
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();
});
După reparație, programul afișează
Status: 200
Produse: Cafea, Ceai, Cană
Indiciu

Serverul ascultă pe http://localhost:3000.

Alte forme ale mesajului

  • TypeError: Failed to parse URL from undefined/produse
  • TypeError: Failed to parse URL from /api/produse [cause]: TypeError: Invalid URL
  • TypeError: fetch failed [cause]: Error: unknown scheme
  • TypeError: 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

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