...
Eroare JavaScript · JSON: parse și stringify

SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON

Pe scurt

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.html pentru 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

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

Greșit
JavaScript
fetch("api/produse") // relativ la pagina curentă, de exemplu /cos/api/produse
Corect
JavaScript
fetch("/api/produse") // de la rădăcina site-ului

Fă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

Greșit
JavaScript
const date = await raspuns.json();
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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);
După reparație, programul afișează
Mouse, Monitor
Eroare server: 404
Indiciu

Verifică raspuns.ok și parsează textul doar dacă e true.

Alte forme ale mesajului

  • SyntaxError: Unexpected token '<', "<html><bod"... is not valid JSON
  • SyntaxError: Unexpected token 'I', "Internal S"... is not valid JSON
  • SyntaxError: Unexpected token < in JSON at position 0
  • SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data

Cum o eviți pe viitor

  • Verifică mereu raspuns.ok (sau raspuns.status) înainte de raspuns.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 /api să 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

← Toate erorile JavaScript

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