SyntaxError: "undefined" is not valid JSON
Ai dat lui `JSON.parse` valoarea `undefined` în loc de un text JSON, de obicei o variabilă goală, o proprietate scrisă greșit sau un rezultat lipsă. `JSON.parse` o transformă în textul „undefined”, care nu e JSON. Verifică de unde vine valoarea și tratează cazul în care lipsește.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
JSON.parse primește un text și îl transformă în obiect. Dacă îi dai altceva decât un text, întâi îl convertește la text: undefined devine "undefined", un obiect devine "[object Object]". Niciunul nu e JSON valid, de aici mesajul "undefined" is not valid JSON.
Așadar problema nu e formatul JSON-ului, ci faptul că nu ai deloc JSON în variabilă. Cauze tipice: citești dintr-o proprietate care nu există (raspuns.body în loc de raspuns.date), dintr-o funcție care nu returnează nimic, sau dintr-un loc de stocare unde cheia lipsește. Varianta "[object Object]" is not valid JSON înseamnă opusul: datele sunt deja un obiect, iar JSON.parse nu mai e necesar.
În versiunile mai vechi de Chrome și Node, același caz apărea ca Unexpected token u in JSON at position 0 (u de la undefined).
De ce apare: cauzele frecvente
1Proprietate care nu există
const mesaj = { tip: "comanda", continut: '{"id": 7}' };
const date = JSON.parse(mesaj.body);const mesaj = { tip: "comanda", continut: '{"id": 7}' };
const date = JSON.parse(mesaj.continut);mesaj.body e undefined. Cu proprietatea corectă, JSON.parse primește un text JSON.
2Date care sunt deja obiect
const user = { nume: "Ana" };
const copie = JSON.parse(user);const user = { nume: "Ana" };
const copie = structuredClone(user);
// sau direct: user.numeJSON.parse e pentru text. Un obiect se folosește direct; mesajul ar fi "[object Object]" is not valid JSON.
3Valoare care poate lipsi
const salvat = undefined; // de exemplu, nicio valoare salvată
const cos = JSON.parse(salvat);const salvat = undefined;
const cos = salvat ? JSON.parse(salvat) : [];Când lipsa e normală (prima vizită, nimic salvat), folosește o valoare implicită.
Repară eroarea, direct în pagină
Programul de mai jos primește un mesaj care conține un JSON cu detaliile unei comenzi și ar trebui să afișeze numărul comenzii și totalul. Se oprește cu SyntaxError: "undefined" is not valid JSON. Repară codul ca să afișeze Comanda 1052: 249.9 lei.
const mesaj = {
tip: "comanda-noua",
continut: '{"id": 1052, "total": 249.9}'
};
const comanda = JSON.parse(mesaj.date);
console.log(`Comanda ${comanda.id}: ${comanda.total} lei`);Comanda 1052: 249.9 lei
Indiciu
În ce proprietate a obiectului mesaj se află, de fapt, textul JSON?
Reparația
const mesaj = {
tip: "comanda-noua",
continut: '{"id": 1052, "total": 249.9}'
};
const comanda = JSON.parse(mesaj.continut);
console.log(`Comanda ${comanda.id}: ${comanda.total} lei`);De ce merge
mesaj.date nu există, deci are valoarea undefined. JSON.parse îl transformă în textul "undefined", care nu e JSON valid. Textul JSON este în proprietatea continut. Odată convertit, obținem un obiect cu id și total, pe care le folosim direct. Mesajul erorii te ajută: dacă vezi "undefined" în el, problema e lipsa datelor, nu formatul lor.
Alte forme ale mesajului
SyntaxError: "[object Object]" is not valid JSONSyntaxError: Unexpected token u in JSON at position 0SyntaxError: Unexpected token o in JSON at position 1SyntaxError: JSON.parse: unexpected character at line 1 column 1 of the JSON data
Cum o eviți pe viitor
- Înainte de
JSON.parse, asigură-te că ai un text:typeof text === "string". - Convertește JSON-ul o singură dată, imediat ce îl primești, și lucrează mai departe doar cu obiectul.
- Pentru valori care pot lipsi, pune o rezervă:
JSON.parse(text ?? "[]"). - Pune
JSON.parseîntry...catchcând textul vine din exterior.
Întrebări frecvente
Ce înseamnă „Unexpected token u in JSON at position 0”?
Este forma veche a aceluiași mesaj: primul caracter, u, vine din textul "undefined". Ai dat undefined lui JSON.parse.
Și „Unexpected token o in JSON at position 1”?
Ai dat un obiect. Convertit la text, el devine "[object Object]", iar al doilea caracter, o, e cel care nu se potrivește. În versiunile noi mesajul spune direct "[object Object]" is not valid JSON.
Erori înrudite
SyntaxError: Unexpected end of JSON input `JSON.parse` a primit un text gol (`""`) sau un JSON tăiat înainte de final. De obicei un răspuns de server fără conținut (de exemplu status 204) sau o valoare salvată goală. Verifică textul înainte să îl parsezi și tratează cazul gol separat. SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON Ai încercat să citești ca JSON un răspuns care este de fapt o pagină HTML, de obicei o pagină de eroare 404 sau 500, ori pagina principală a aplicației întoarsă pentru o adresă greșită. Verifică URL-ul cererii și `raspuns.ok` înainte de `.json()`, și uită-te la răspuns în tab-ul Network. TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
