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

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

Pe scurt

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

Greșit
JSX
fetch("/api/produs")
  .then((r) => r.json())
Corect
JSX
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

Greșit
JSX
const r = await fetch(URL);
const date = await r.json();
Corect
JSX
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ă

Greșit
JSX
// vite.config.js fără proxy
fetch("/api/comenzi")
Corect
JSX
// vite.config.js
server: { proxy: { "/api": "http://localhost:3001" } }

Fără proxy, /api/... ajunge la serverul Vite, care răspunde cu index.html.

Repară tu

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.

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

Alte forme ale mesajului

  • SyntaxError: Unexpected token < in JSON at position 0
  • SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
  • SyntaxError: Unexpected end of JSON input
  • SyntaxError: 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 de res.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

← 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.