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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
E eroarea JavaScript standard a lui JSON.parse când textul primit nu e JSON. În versiunile recente de Node și de browsere arată așa:
SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSONiar în versiunile mai vechi: Unexpected token < in JSON at position 0. Ambele spun același lucru: primul caracter e <, deci textul e HTML sau XML.
În Postman apare când scriptul face JSON.parse(pm.response.text()) sau JSON.parse(responseBody) (sintaxa veche) pe un răspuns HTML: pagină de eroare, pagină de login, URL greșit.
Ca la JSONError, soluția e să afli de ce serverul a trimis HTML (Raw/Preview, status, URL) și să scrii testele așa încât să verifice formatul înainte de parsare.
De ce apare: cauzele frecvente
1Parsare manuală a unui răspuns HTML
const j = JSON.parse(pm.response.text());pm.expect(pm.response.headers.get("Content-Type")).to.include("json");
const j = pm.response.json();Verificarea formatului transformă eroarea de script într-un test clar.
2Sintaxa veche responseBody
var j = JSON.parse(responseBody);const j = pm.response.json();pm.response.json() e varianta actuală, cu mesaje de eroare mai clare.
Repară eroarea, direct în pagină
Cererea „Pagină demo” (https://echo.test/html) are scriptul JSON.parse(pm.response.text()), care dă SyntaxError: Unexpected token '<'. Răspunsul e HTML, intenționat. Înlocuiește scriptul cu un test care verifică faptul că body-ul începe cu <!DOCTYPE html>. Salvează și trimite.
Indiciu
Lucrează cu textul răspunsului, fără parsare JSON.
Reparația
pm.test("Răspuns HTML", function () {
pm.expect(pm.response.text()).to.match(/^<!DOCTYPE html>/);
});De ce merge
Textul răspunsului e HTML, deci JSON.parse nu-l poate interpreta. Testul nou verifică exact ce trebuie pentru o pagină: începutul documentului. JSON.parse primea un text care nu începea cu { sau [. Când parsezi doar răspunsuri JSON (sau corectezi cererea), scriptul citește datele fără eroare și testele pot rula.
Alte forme ale mesajului
SyntaxError: Unexpected token < in JSON at position 0SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
Cum o eviți pe viitor
- Folosește
pm.response.json(), nuJSON.parse(responseBody). - Verifică statusul și Content-Type înainte de parsare.
- Când vezi
<în mesaj, deschide Preview: vei vedea pagina primită. - Folosește
pm.response.json()doar pe răspunsuri JSON; pentru restul,pm.response.text(). - Loghează
pm.response.text().slice(0, 100)când parsarea pică. - Verifică statusul înainte de parsare.
Întrebări frecvente
Ce înseamnă position 0?
Primul caracter din text (numărătoarea începe de la 0). Problema e chiar de la început.
De ce în Postman merge și în Newman nu?
În Newman poate lipsi un token sau un cookie, iar serverul redirecționează spre o pagină de login HTML.
Erori înrudite
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. 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ă. SyntaxError: "undefined" is not valid JSON JSON.parse a primit undefined, de obicei pentru că variabila citită cu pm.environment.get sau pm.collectionVariables.get nu există (alt nume, alt scope, cererea care o setează nu a rulat). Verifică variabila înainte de parsare și asigură-te că a fost salvată cu JSON.stringify. Î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.
