JSONError: Unexpected token '<' at 1:1
pm.response.json() a încercat să parseze ca JSON un răspuns care începe cu „<”, adică o pagină HTML (o eroare 404/500 a serverului, o pagină de login, un proxy). Uită-te la body în Raw sau Preview și la Content-Type, apoi repară cererea sau verifică statusul înainte să parsezi.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Mesajul vine din parserul JSON al lui Postman: la linia 1, coloana 1, a găsit caracterul < în loc de { sau [. Sub mesaj, Postman afișează începutul body-ului, de obicei <!DOCTYPE html> sau <html>.
Deci serverul a răspuns cu HTML, nu cu JSON. Motive frecvente:
- URL greșit: ai nimerit pe site-ul web, nu pe API (
/productsîn loc de/api/products); - o pagină de eroare a serverului web (404, 500, 502 de la nginx);
- o pagină de login sau de consimțământ, după o redirecționare;
- un API care întoarce erorile ca HTML (bug de raportat).
Regula sănătoasă: în teste, verifici întâi statusul și Content-Type, apoi parsezi. Așa, un răspuns HTML produce un test picat clar („expected text/html to include application/json”), nu o eroare de script care oprește toate testele.
De ce apare: cauzele frecvente
1URL spre site în loc de API
GET https://magazin.test/products
pm.response.json()GET https://api.magazin.test/products
pm.response.json()Site-ul întoarce pagini HTML; API-ul întoarce JSON.
2Parsare fără verificarea tipului
const j = pm.response.json();pm.test("Răspuns JSON", () => pm.expect(pm.response.headers.get("Content-Type")).to.include("application/json"));
if (pm.response.headers.get("Content-Type").includes("json")) {
const j = pm.response.json();
}Un test pe Content-Type explică problema fără eroare de script.
3Eroare HTML de la server
GET /products/999 → 404 <html>...# raportează: erorile API-ului trebuie să fie JSONClienții API se așteaptă la același format și la erori.
Repară eroarea, direct în pagină
Cererea „Pagină demo” cere https://echo.test/html, care întoarce o pagină HTML, iar scriptul face pm.response.json() și dă JSONError: Unexpected token '<' at 1:1. Înlocuiește scriptul cu un test care verifică faptul că răspunsul e HTML (Content-Type include text/html) și conține tagul <h1>. Salvează și trimite.
Indiciu
Pentru HTML folosește pm.response.text(), nu json().
Reparația
pm.test("Răspunsul e HTML cu titlu", function () {
pm.expect(pm.response.headers.get("Content-Type")).to.include("text/html");
pm.expect(pm.response.text()).to.include("<h1>");
});De ce merge
Body-ul e HTML, deci parserul JSON se oprea la primul caracter. Testul citește acum body-ul ca text, iar verificarea Content-Type face clar formatul așteptat. Caracterul < de pe prima poziție arată că răspunsul e HTML, nu JSON. După ce cererea ajunge la endpoint-ul corect, răspunsul e JSON și scriptul îl poate citi.
Alte forme ale mesajului
JSONError: Unexpected token 'O' at 1:1JSONError: Unexpected token '<' at 1:1 <!DOCTYPE html>
Cum o eviți pe viitor
- Pune un test pe
Content-Typeînaintea testelor pe body. - Uită-te la Raw/Preview când un test dă eroare de parsare.
- Verifică URL-ul final în Console.
- Verifică
Content-Typeînainte depm.response.json(). - Loghează primele caractere ale răspunsului când parsarea pică.
Întrebări frecvente
De ce Postman îmi arată pagina frumos în Preview?
Pentru că e HTML: Preview o randează ca un browser.
E la fel cu SyntaxError: Unexpected token '<'?
E aceeași problemă. JSONError apare la pm.response.json(), SyntaxError la JSON.parse(...).
Erori înrudite
SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON JSON.parse a primit un text HTML (începe cu <!DOCTYPE), nu JSON. Serverul a răspuns cu o pagină, nu cu date. Verifică statusul, Content-Type și URL-ul; în scripturi folosește pm.response.json() doar după ce ai confirmat că răspunsul e JSON. Răspunsul e HTML în loc de JSON (Content-Type: text/html) Endpointul unui API JSON a întors o pagină HTML (des la erori 404 sau 500), deci clienții nu pot citi eroarea. Dacă URL-ul e corect, e un bug de contract: scrie un test pe Content-Type și raportează-l cu cererea atașată. 404 Not Found Serverul nu are resursa sau ruta cerută: calea e scrisă greșit (singular/plural, versiune lipsă), id-ul nu există sau metoda și calea nu se potrivesc. Compară URL-ul final din Console cu documentația și verifică id-ul. Învață Postman de la zero, cu exerciții la fiecare lecție
Curs API Testing cu Postman: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
