SyntaxError: Bad control character in string literal in JSON at position 30 (line 1 column 31)
În textul JSON, o valoare dintre ghilimele conține un caracter de control pus direct: o linie nouă (Enter), un tab. JSON acceptă aceste caractere doar scrise ca secvențe: \n, \t. Generează JSON-ul cu JSON.stringify (care le transformă singur) sau înlocuiește-le înainte de JSON.parse.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În JSON, textele dintre ghilimele nu pot conține caractere de control (codurile 0-31): linie nouă, retur de car, tab și altele. Ele trebuie scrise ca secvențe de escape: \n, \r, \t. Când JSON.parse întâlnește un astfel de caracter „brut” în interiorul unui text, se oprește cu această eroare. Poziția din mesaj (at position 30) e indexul caracterului problematic, numărat de la 0.
De unde vine textul greșit:
- JSON scris de mână într-un template literal (`
...`) pe mai multe rânduri, cu Enter în mijlocul unei valori; - JSON construit prin concatenare de texte, cu valori care conțin linii noi (adrese, comentarii, descrieri);
- date copiate din Excel sau dintr-un editor, cu taburi între coloane.
Nu e o problemă de structură (acolade, virgule), ci de conținutul unei valori. Afișează JSON.stringify(text.slice(poz - 10, poz + 10)) ca să vezi caracterul invizibil (apare ca \n sau \t).
De ce apare: cauzele frecvente
1Enter în mijlocul unei valori, în template literal
const text = `{"adresa": "Str. Lalelelor 5
Bl. A2"}`;
JSON.parse(text);const text = `{"adresa": "Str. Lalelelor 5\\nBl. A2"}`;
JSON.parse(text);\\n în template ajunge în JSON ca secvența \n, pe care parserul o transformă în linie nouă.
2JSON construit prin concatenare
const json = '{"nota": "' + comentariu + '"}';const json = JSON.stringify({ nota: comentariu });JSON.stringify escapează singur liniile noi, taburile și ghilimelele.
3Tab copiat din Excel într-un JSON scris de mână
const rand = "Ana\t25"; // tab real
JSON.parse(`{"rand": "${rand}"}`);const rand = "Ana\t25";
JSON.parse(JSON.stringify({ rand }));Textul generat de JSON.stringify conține \t scris ca secvență, deci se parsează corect.
Repară eroarea, direct în pagină
Programul citește un client dintr-un text JSON scris pe două rânduri, dar se oprește cu SyntaxError: Bad control character in string literal in JSON. Repară textul JSON (adresa trebuie să rămână pe două rânduri) ca programul să afișeze Client: Ana și Adresa are 2 rânduri.
const text = `{"nume": "Ana", "adresa": "Str. Lalelelor 5
Bl. A2"}`;
const client = JSON.parse(text);
console.log(`Client: ${client.nume}`);
console.log(`Adresa are ${client.adresa.split("\n").length} rânduri`);Client: Ana Adresa are 2 rânduri
Indiciu
În JSON, linia nouă din interiorul unei valori se scrie ca \n; într-un template literal asta înseamnă \\n.
Reparația
const text = `{"nume": "Ana", "adresa": "Str. Lalelelor 5\\nBl. A2"}`;
const client = JSON.parse(text);
console.log(`Client: ${client.nume}`);
console.log(`Adresa are ${client.adresa.split("\n").length} rânduri`);De ce merge
În template literal, Enter-ul din mijlocul adresei ajungea în textul JSON ca un caracter real de linie nouă, interzis în interiorul ghilimelelor JSON. Cu \\n în template, textul JSON conține secvența de doi caractere \n, care e escape-ul corect. JSON.parse o transformă înapoi într-o linie nouă reală, deci adresa are tot două rânduri.
Alte forme ale mesajului
SyntaxError: Bad control character in string literal in JSON at position 8 (line 1 column 9)SyntaxError: JSON.parse: bad control character in string literal at line 1 column 31 of the JSON dataSyntaxError: Bad control character in string literal in JSON at position 30
Cum o eviți pe viitor
- Nu construi JSON de mână: folosește
JSON.stringifype un obiect. - Dacă primești JSON stricat de la alt sistem, cere repararea la sursă; ca soluție temporară, înlocuiește caracterele:
text.replace(/\n/g, "\\n"), doar dacă știi că sunt în valori. - În teste, pune JSON-ul în fișiere
.json, validate de editor. - Validează răspunsurile API cu un
try/catchși loghează fragmentul din jurul poziției.
Întrebări frecvente
De ce liniile noi dintre câmpuri nu dau eroare?
Spațiile, taburile și liniile noi sunt permise între elementele JSON (după virgule, în jurul acoladelor). Sunt interzise doar în interiorul unui text dintre ghilimele.
Pot face JSON.parse să accepte caracterele?
Nu, JSON e un format strict. Ori repari textul înainte, ori folosești un parser tolerant (de exemplu JSON5) doar pentru fișiere de configurare scrise de oameni.
Erori înrudite
SyntaxError: Bad escaped character in JSON at position 13 (line 1 column 14) În textul JSON există un backslash urmat de un caracter care nu formează o secvență validă, de obicei într-o cale Windows ("C:\Proiecte") sau un \' copiat din JavaScript. În JSON, backslash-ul se dublează ("C:\\Proiecte"); cel mai sigur e să generezi textul cu JSON.stringify. 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: Expected double-quoted property name in JSON at position 29 (line 1 column 30) În textul JSON există o virgulă după ultima proprietate a unui obiect (`{"a": 1,}`), iar JSON nu permite virgula finală. Șterge virgula de dinaintea lui `}`. Dacă JSON-ul e generat de cod, folosește `JSON.stringify` în loc de concatenare. Î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.
