TypeError: Failed to fetch
Cererea fetch nu a primit niciun răspuns: serverul nu rulează, adresa e greșită (alt port, http/https) sau browserul a blocat-o (CORS). Verifică adresa în tab-ul Network și prinde eroarea cu .catch ca să afișezi un mesaj.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
fetch aruncă TypeError: Failed to fetch când cererea nu ajunge să primească un răspuns HTTP. Atenție la diferență: un răspuns 404 sau 500 nu produce eroarea asta (pentru ele fetch reușește, iar res.ok este false). „Failed to fetch” înseamnă că nu a existat niciun răspuns pe care browserul să ți-l dea.
Cauze frecvente: serverul de API nu este pornit (localhost:3001 oprit), adresa are portul sau protocolul greșit, numele de domeniu nu există, rețeaua e căzută, browserul blochează cererea din motive CORS (serverul nu trimite antetul Access-Control-Allow-Origin) sau o pagină https cere o adresă http (mixed content).
În tab-ul Network din DevTools vezi cererea cu statusul „(failed)” și motivul, iar în consolă, la CORS, un mesaj separat cu detalii. Fără .catch, eroarea rămâne neprinsă și pagina nu îi spune nimic utilizatorului.
De ce apare: cauzele frecvente
1Server local oprit sau port greșit
fetch("http://localhost:3001/produse")// pornește API-ul (npm run server) sau folosește adresa corectă
fetch("https://api.exemplu.ro/produse")Când la adresa respectivă nu răspunde nimeni, browserul nu are ce răspuns să-ți dea.
2Cerere fără tratarea erorii
fetch(URL)
.then((r) => r.json())
.then(setProduse);fetch(URL)
.then((r) => r.json())
.then(setProduse)
.catch(() => setEroare("Nu am putut încărca produsele."));Cu .catch eroarea este prinsă, iar utilizatorul vede un mesaj în loc de o pagină goală.
3Cerere blocată de CORS
// API pe alt domeniu, fără antet CORS
fetch("https://api.altdomeniu.ro/date")// pe server: Access-Control-Allow-Origin: https://site-ul-tau.ro
// sau, în dezvoltare, proxy în vite.config.js
fetch("/api/date")CORS se rezolvă pe server sau printr-un proxy; din codul React nu poți ocoli regula browserului.
Repară eroarea, direct în pagină
Componenta de mai jos cere produsele de la http://localhost:3001/produse, un server care nu rulează, iar cererea eșuează cu „TypeError: Failed to fetch”, neprinsă. API-ul real este https://api.exemplu.ro/produse. Folosește adresa corectă și adaugă tratarea erorii (.catch), ca lista să afișeze cele două produse.
import { useState, useEffect } from "react";
export default function App() {
const [produse, setProduse] = useState([]);
const [eroare, setEroare] = useState("");
useEffect(() => {
fetch("http://localhost:3001/produse")
.then((r) => r.json())
.then((date) => setProduse(date));
}, []);
if (eroare) return <p id="eroare">{eroare}</p>;
return (
<ul>
{produse.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}Indiciu
Schimbă adresa și adaugă un .catch care pune mesajul în state.
Reparația
import { useState, useEffect } from "react";
export default function App() {
const [produse, setProduse] = useState([]);
const [eroare, setEroare] = useState("");
useEffect(() => {
fetch("https://api.exemplu.ro/produse")
.then((r) => r.json())
.then((date) => setProduse(date))
.catch(() => setEroare("Nu am putut încărca produsele."));
}, []);
if (eroare) return <p id="eroare">{eroare}</p>;
return (
<ul>
{produse.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}De ce merge
fetch aruncă TypeError: Failed to fetch când la adresa cerută nu răspunde nimeni: aici, un server local care nu este pornit. Cum promisiunea nu are .catch, eroarea rămâne neprinsă și lista rămâne goală fără nicio explicație.
Cu adresa corectă, cererea primește răspuns și lista se completează. .catch nu e necesar ca să meargă azi, dar face componenta robustă: dacă rețeaua sau serverul cad, utilizatorul vede mesajul din #eroare în loc de o pagină goală.
Alte forme ale mesajului
TypeError: NetworkError when attempting to fetch resource.TypeError: Load failedAccess to fetch at 'http://localhost:3001/produse' from origin 'http://localhost:5173' has been blocked by CORS policy: No 'Access-Control-Allow-Origin' header is present on the requested resource.Uncaught (in promise) TypeError: Failed to fetch
Cum o eviți pe viitor
- Ține adresa API-ului într-o singură constantă sau variabilă de mediu (
import.meta.env.VITE_API_URL). - Prinde mereu erorile de rețea (
.catchsautry/catchcuawait) și afișează o stare de eroare. - Verifică separat
res.ok, pentru răspunsurile 4xx și 5xx. - La o eroare, deschide întâi tab-ul Network: îți spune dacă cererea a plecat, unde și de ce a eșuat.
Întrebări frecvente
De ce primesc Failed to fetch, dar adresa merge în browser?
Cel mai probabil e CORS: deschisă direct în browser, adresa nu e supusă acestei reguli, dar cererea fetch dintr-o pagină de pe alt domeniu este. Uită-te în consolă după mesajul cu „blocked by CORS policy”.
Un 404 dă tot Failed to fetch?
Nu. La 404 serverul răspunde, iar fetch se rezolvă normal, cu res.ok === false și res.status === 404. Trebuie să verifici res.ok tu.
Erori înrudite
SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON Ai apelat res.json() pe un răspuns care este HTML, nu JSON: de obicei adresa API-ului e greșită și serverul a trimis o pagină (index.html sau 404). Verifică adresa și res.ok înainte de res.json(). Warning: useEffect must not return anything besides a function, which is used for clean-up. Ai scris useEffect(async () => ...): o funcție async întoarce o promisiune, iar efectul are voie să întoarcă doar o funcție de curățare. Definește funcția async în interiorul efectului și apeleaz-o. TypeError: Cannot read properties of undefined (reading 'map') Apelezi .map pe o variabilă care este undefined, de obicei pentru că datele nu s-au încărcat încă sau prop-ul nu a fost trimis. Pornește state-ul cu un tablou gol, useState([]), sau verifică variabila înainte de map. Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
