SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
Ai încercat să citești ca JSON un răspuns care este de fapt o pagină HTML, de obicei o pagină de eroare 404 sau 500, ori pagina principală a aplicației întoarsă pentru o adresă greșită. Verifică URL-ul cererii și `raspuns.ok` înainte de `.json()`, și uită-te la răspuns în tab-ul Network.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul arată primul caracter neașteptat ('<') și începutul textului primit ("<!DOCTYPE "...). Un JSON începe cu {, [, ", o cifră, true, false sau null, niciodată cu <. Textul primit e HTML.
Situația clasică: fetch("/api/produse") urmat de await raspuns.json(), dar serverul răspunde cu o pagină HTML în loc de date:
- adresa e greșită și serverul trimite pagina 404;
- serverul a dat eroare și trimite o pagină 500;
- într-o aplicație cu rutare în browser (React, Vue), serverul de dezvoltare întoarce
index.htmlpentru orice adresă necunoscută; - sesiunea a expirat și răspunsul e pagina de login.
Cu alte începuturi, mesajul se schimbă: Unexpected token 'I', "Internal S"... is not valid JSON pentru textul „Internal Server Error”. Ideea e aceeași: răspunsul nu e JSON. Cea mai rapidă verificare: tab-ul Network din DevTools, unde vezi statusul și corpul răspunsului.
De ce apare: cauzele frecvente
1Răspuns de eroare citit ca JSON
const raspuns = await fetch("/api/produse");
const produse = await raspuns.json();const raspuns = await fetch("/api/produse");
if (!raspuns.ok) {
throw new Error(`Eroare server: ${raspuns.status}`);
}
const produse = await raspuns.json();raspuns.ok e false pentru statusuri 4xx și 5xx. Verifică-l înainte să citești corpul ca JSON.
2Adresă greșită
fetch("api/produse") // relativ la pagina curentă, de exemplu /cos/api/produsefetch("/api/produse") // de la rădăcina site-uluiFără / la început, adresa e relativă la pagina curentă și poate ajunge la o rută care întoarce HTML.
3Răspuns care nu e JSON, verificat după tip
const date = await raspuns.json();const tip = raspuns.headers.get("content-type") || "";
const date = tip.includes("application/json") ? await raspuns.json() : null;Antetul content-type îți spune ce format are răspunsul înainte să încerci să îl parsezi.
Repară eroarea, direct în pagină
Funcția de mai jos simulează răspunsuri de la un server: unul cu JSON, altul cu o pagină de eroare HTML. Programul se oprește cu SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON. Repară funcția citesteProduse ca să verifice ok înainte de parsare și, la eroare, să afișeze Eroare server: 404.
const raspunsuri = [
{ ok: true, status: 200, text: '["Mouse", "Monitor"]' },
{ ok: false, status: 404, text: "<!DOCTYPE html><html><body>Pagina nu există</body></html>" }
];
function citesteProduse(raspuns) {
const produse = JSON.parse(raspuns.text);
console.log(produse.join(", "));
}
raspunsuri.forEach(citesteProduse);Mouse, Monitor Eroare server: 404
Indiciu
Verifică raspuns.ok și parsează textul doar dacă e true.
Reparația
const raspunsuri = [
{ ok: true, status: 200, text: '["Mouse", "Monitor"]' },
{ ok: false, status: 404, text: "<!DOCTYPE html><html><body>Pagina nu există</body></html>" }
];
function citesteProduse(raspuns) {
if (!raspuns.ok) {
console.log(`Eroare server: ${raspuns.status}`);
return;
}
const produse = JSON.parse(raspuns.text);
console.log(produse.join(", "));
}
raspunsuri.forEach(citesteProduse);De ce merge
Al doilea răspuns este o pagină HTML de eroare, care începe cu <, caracter cu care niciun JSON nu poate începe. În cod real, fetch îți dă un obiect Response cu aceleași câmpuri: ok (adevărat pentru statusurile 200–299) și status. Verificând ok înainte de parsare, tratezi eroarea serverului ca eroare, cu statusul ei, în loc să încerci să citești HTML ca JSON.
Alte forme ale mesajului
SyntaxError: Unexpected token '<', "<html><bod"... is not valid JSONSyntaxError: Unexpected token 'I', "Internal S"... is not valid JSONSyntaxError: Unexpected token < in JSON at position 0SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
Cum o eviți pe viitor
- Verifică mereu
raspuns.ok(sauraspuns.status) înainte deraspuns.json(). - Când ceva nu merge, citește răspunsul ca text (
await raspuns.text()) și afișează-l: vezi imediat dacă e HTML. - Folosește adrese absolute pentru API (
/api/...sau URL complet). - Configurează serverul ca rutele
/apisă răspundă cu JSON chiar și la erori.
Întrebări frecvente
Pe calculatorul meu merge, pe server nu. De ce?
Probabil adresa API-ului e alta în producție, sau serverul nu are ruta configurată și întoarce pagina principală. Verifică în tab-ul Network ce adresă se cere și ce răspuns vine.
De ce primesc HTML chiar dacă statusul e 200?
Multe servere pentru aplicații cu rutare în browser întorc index.html cu status 200 pentru orice adresă necunoscută. Adresa API e greșită sau nu e configurată pe server.
Erori înrudite
SyntaxError: "undefined" is not valid JSON Ai dat lui `JSON.parse` valoarea `undefined` în loc de un text JSON, de obicei o variabilă goală, o proprietate scrisă greșit sau un rezultat lipsă. `JSON.parse` o transformă în textul „undefined”, care nu e JSON. Verifică de unde vine valoarea și tratează cazul în care lipsește. SyntaxError: Unexpected end of JSON input `JSON.parse` a primit un text gol (`""`) sau un JSON tăiat înainte de final. De obicei un răspuns de server fără conținut (de exemplu status 204) sau o valoare salvată goală. Verifică textul înainte să îl parsezi și tratează cazul gol separat. Uncaught (in promise) Error: Request failed O promisiune a fost respinsă (o funcție `async` a aruncat o eroare sau o cerere a eșuat), iar nimeni nu a prins eroarea cu `try...catch` sau `.catch()`. Pune `await` în interiorul unui `try...catch`, sau adaugă `.catch()` la apelul funcției `async`. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
