...
Eroare React · useEffect și încărcarea datelor

TypeError: Failed to fetch

Pe scurt

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

Greșit
JSX
fetch("http://localhost:3001/produse")
Corect
JSX
// 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

Greșit
JSX
fetch(URL)
  .then((r) => r.json())
  .then(setProduse);
Corect
JSX
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

Greșit
JSX
// API pe alt domeniu, fără antet CORS
fetch("https://api.altdomeniu.ro/date")
Corect
JSX
// 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ă tu

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.

Codul care dă eroarea
JSX
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.

Alte forme ale mesajului

  • TypeError: NetworkError when attempting to fetch resource.
  • TypeError: Load failed
  • Access 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 (.catch sau try/catch cu await) ș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

← Toate erorile React

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ță 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.