...
Eroare Testare automată · Navigare, rețea și teste de API

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

Pe scurt

Ai apelat .json() pe un răspuns care nu e JSON: de obicei o pagină HTML (eroare 404, login, adresa greșită). Verifică adresa cererii (calea /api/...), afișează status-ul și text() înainte de json() și pune expect(raspuns).toBeOK() înainte.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

response.json() încearcă să interpreteze corpul răspunsului ca JSON. Mesajul spune că primul caracter (<) nu poate începe un JSON, iar începutul textului ("<!DOCTYPE "...) arată că ai primit HTML. Serverul a răspuns, dar nu cu ce așteptai.

Cele mai dese motive: calea e greșită (lipsește /api sau e o greșeală de tipar) și serverul întoarce pagina aplicației sau o pagină 404 în HTML; cererea nu e autorizată și serverul redirecționează la pagina de login; un proxy sau un server de dezvoltare servește index.html pentru orice adresă. Uneori corpul e gol (Unexpected end of JSON input), de exemplu la un răspuns 204 No Content. Primul pas e mereu să afișezi status() și await raspuns.text(): vezi imediat ce a venit de fapt.

De ce apare: cauzele frecvente

1Adresa cererii nu e cea a API-ului

Greșit
JavaScript
const r = await request.get('/raport');
const date = await r.json();
Corect
JavaScript
const r = await request.get('/api/raport');
const date = await r.json();

/raport e pagina HTML a aplicației. API-ul răspunde cu JSON la /api/raport.

2Cererea neautorizată întoarce pagina de login

Greșit
JavaScript
const r = await request.get('/api/orders');
const comenzi = await r.json();
Corect
JavaScript
const r = await request.get('/api/orders', { headers: { Authorization: `Bearer ${token}` } });
await expect(r).toBeOK();
const comenzi = await r.json();

Unele servere redirecționează la login fără token. toBeOK înainte de json arată clar statusul problemă.

3Răspuns fără corp

Greșit
JavaScript
const r = await request.delete('/api/cart/1');
const corp = await r.json();
Corect
JavaScript
const r = await request.delete('/api/cart/1');
expect(r.status()).toBe(204);

Un răspuns 204 nu are corp, deci json() dă Unexpected end of JSON input. Verifică doar statusul.

Repară tu

Repară eroarea, direct în pagină

Testul raportul de vânzări are 3 comenzi pică la raspuns.json(): serverul a trimis o pagină HTML (<!DOCTYPE html>...). În acest proiect, /raport este pagina din interfață, iar API-ul răspunde la /api/raport cu { comenzi, total }. Repară cererea, verifică răspunsul cu toBeOK(), apoi verifică și afișează numărul de comenzi.

Codul care dă eroarea
JavaScript
import { test, expect } from '@playwright/test';

test('raportul de vânzări are 3 comenzi', async ({ request }) => {
  const raspuns = await request.get('/raport');
  const date = await raspuns.json();
  expect(date.comenzi).toBe(3);
});
Indiciu

Pagina și API-ul au adrese diferite.

Alte forme ale mesajului

  • SyntaxError: Unexpected end of JSON input
  • SyntaxError: Unexpected token 'N', "Not Found" is not valid JSON
  • SyntaxError: Unexpected token < in JSON at position 0
  • Error: response.json: Unexpected token in JSON

Cum o eviți pe viitor

  • Pune await expect(raspuns).toBeOK() înainte de json(): dacă statusul e greșit, raportul arată cererea și răspunsul.
  • Ține adresele API într-un singur loc (constante sau un client API ca fixture), nu scrise de mână în fiecare test.
  • Când scrii un test nou, afișează o dată status(), headers()['content-type'] și text().

Întrebări frecvente

De ce statusul e 200, dar tot primesc HTML?

Multe aplicații (SPA) servesc index.html cu 200 pentru orice adresă necunoscută, ca rutarea să meargă în browser. Pentru API, o adresă greșită arată deci ca un succes. Verifică și content-type: trebuie să fie application/json.

Mesajul e diferit pe Node mai vechi. E aceeași eroare?

Da. Versiunile mai vechi de Node scriu Unexpected token < in JSON at position 0; cele noi includ începutul textului. Cauza și reparația sunt aceleași.

Erori înrudite

← Toate erorile Testare automată

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ță Testare automată de la zero, cu exerciții la fiecare lecție

Curs Test Automation (Playwright și Selenium): lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 20 lecții sunt gratuite.