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().
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
res.json() încearcă să citească răspunsul ca JSON. Primul caracter primit a fost <, iar textul începe cu <!DOCTYPE, deci serverul a trimis o pagină HTML, iar JSON-ul nu poate începe cu <.
De ce primești HTML? Cel mai des pentru că adresa nu este cea a API-ului: o cale relativă greșită (/api/produs în loc de /api/produse), un proxy neconfigurat în Vite sau CRA (serverul de dezvoltare răspunde cu index.html la orice cale necunoscută), o pagină de eroare 404/500 a serverului sau o pagină de login la care te-a redirecționat serverul.
Ca să vezi ce ai primit, deschide cererea în tab-ul Network → Response sau folosește temporar res.text() în loc de res.json() și afișează textul.
De ce apare: cauzele frecvente
1Cale greșită către API
fetch("/api/produs")
.then((r) => r.json())fetch("https://api.exemplu.ro/produse")
.then((r) => r.json())La o cale necunoscută, serverul de dezvoltare întoarce pagina aplicației (HTML), nu datele.
2res.json() fără verificarea lui res.ok
const r = await fetch(URL);
const date = await r.json();const r = await fetch(URL);
if (!r.ok) throw new Error("Eroare " + r.status);
const date = await r.json();Un 404 sau 500 vine adesea cu o pagină HTML; verificând ok primești un mesaj clar în loc de o eroare de parsare.
3Proxy de dezvoltare lipsă
// vite.config.js fără proxy
fetch("/api/comenzi")// vite.config.js
server: { proxy: { "/api": "http://localhost:3001" } }Fără proxy, /api/... ajunge la serverul Vite, care răspunde cu index.html.
Repară eroarea, direct în pagină
Componenta de mai jos cere produsele de la /api/produs, o cale care nu există: serverul răspunde cu o pagină HTML 404, iar r.json() aruncă „Unexpected token '<', "<!DOCTYPE "... is not valid JSON”. Folosește adresa API-ului, https://api.exemplu.ro/produse, și verifică r.ok înainte de r.json(). Lista trebuie să afișeze cele trei produse.
import { useState, useEffect } from "react";
export default function App() {
const [produse, setProduse] = useState([]);
const [eroare, setEroare] = useState("");
useEffect(() => {
fetch("/api/produs")
.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
Dacă r.ok este false, aruncă o eroare în loc să citești JSON.
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) => {
if (!r.ok) throw new Error("Eroare " + r.status);
return r.json();
})
.then((date) => setProduse(date))
.catch((e) => setEroare(e.message));
}, []);
if (eroare) return <p id="eroare">{eroare}</p>;
return (
<ul>
{produse.map((p) => <li key={p.id}>{p.nume}</li>)}
</ul>
);
}De ce merge
Calea /api/produs nu există, iar serverul răspunde cu o pagină HTML de eroare. r.json() încearcă să citească pagina ca JSON, dă peste < de la <!DOCTYPE și aruncă SyntaxError.
Cu adresa corectă primești JSON, iar lista se completează. Verificarea r.ok te protejează pe viitor: dacă serverul răspunde cu 404 sau 500, primești un mesaj clar („Eroare 404”) în loc de o eroare de parsare care te trimite pe o pistă greșită.
Alte forme ale mesajului
SyntaxError: Unexpected token < in JSON at position 0SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON dataSyntaxError: Unexpected end of JSON inputSyntaxError: Unexpected token 'N', "Not Found" is not valid JSON
Cum o eviți pe viitor
- Ține adresa de bază a API-ului într-o constantă și construiește căile din ea.
- Verifică
res.okînainte deres.json()și aruncă o eroare cu statusul. - Când apare o eroare de parsare, uită-te întâi la răspunsul brut în tab-ul Network.
Întrebări frecvente
Ce înseamnă „Unexpected end of JSON input”?
Răspunsul a fost gol (de exemplu 204 No Content sau un server care a răspuns fără corp). res.json() nu are ce citi. Verifică statusul și nu apela json() pe răspunsurile fără conținut.
Aceeași eroare în Firefox arată altfel. E aceeași problemă?
Da. Firefox afișează „JSON.parse: unexpected character at line 1 column 1 of the JSON data”, iar versiunile mai vechi de Chrome „Unexpected token < in JSON at position 0”. Toate înseamnă că răspunsul nu e JSON.
Erori înrudite
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. TypeError: produse.map is not a function Variabila pe care apelezi map există, dar nu este un tablou: de obicei e obiectul întreg primit de la API ({ produse: [...] }) sau un string. Pune în state tabloul din interiorul răspunsului, de exemplu data.produse. 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. Î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.
