SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON
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
const r = await request.get('/raport');
const date = await r.json();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
const r = await request.get('/api/orders');
const comenzi = await r.json();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
const r = await request.delete('/api/cart/1');
const corp = await r.json();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ă 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.
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.
Reparația
import { test, expect } from '@playwright/test';
test('raportul de vânzări are 3 comenzi', async ({ request }) => {
const raspuns = await request.get('/api/raport');
await expect(raspuns).toBeOK();
const date = await raspuns.json();
expect(date.comenzi).toBe(3);
console.log(date.comenzi);
});De ce merge
request.get('/raport') primea pagina HTML a aplicației, iar json() nu poate interpreta HTML, deci a dat eroarea de sintaxă JSON. Calea corectă a API-ului este /api/raport, care răspunde cu { "comenzi": 3, "total": 1497 }.
await expect(raspuns).toBeOK() pus înainte de json() face ca, pe viitor, o adresă greșită sau un 401 să apară clar în raport (cu statusul), nu ca o eroare de parsare.
Alte forme ale mesajului
SyntaxError: Unexpected end of JSON inputSyntaxError: Unexpected token 'N', "Not Found" is not valid JSONSyntaxError: Unexpected token < in JSON at position 0Error: response.json: Unexpected token in JSON
Cum o eviți pe viitor
- Pune
await expect(raspuns).toBeOK()înainte dejson(): 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']șitext().
Î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
Error: apiRequestContext.get: 404 Not Found Serverul a răspuns cu 404, iar cererea avea failOnStatusCode: true, deci Playwright a aruncat eroare. Ruta e scrisă greșit (de ex. /api/produse în loc de /api/products), resursa nu există sau lipsește un prefix de versiune. Verifică ruta exactă în documentația API-ului. Error: expect(response).toBeOK() failed Răspunsul HTTP verificat nu are un status de succes (200–299). Raportul arată cererea și statusul primit, de ex. 400, 401 sau 404: corpul cererii e greșit, lipsește autentificarea sau ruta nu există. Citește corpul răspunsului (await r.text()) ca să vezi mesajul serverului. Error: route.continue: Route is already handled! Același request a fost rezolvat de două ori în handler-ul lui page.route: de exemplu fulfill() și apoi continue(). Fiecare cerere primește un singur răspuns; pune return după fulfill sau folosește if / else, ca pe fiecare drum să se apeleze exact o metodă. Î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.
