...
Eroare JavaScript · JSON: parse și stringify

SyntaxError: Bad control character in string literal in JSON at position 30 (line 1 column 31)

Pe scurt

Î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

Greșit
JavaScript
const text = `{"adresa": "Str. Lalelelor 5
Bl. A2"}`;
JSON.parse(text);
Corect
JavaScript
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

Greșit
JavaScript
const json = '{"nota": "' + comentariu + '"}';
Corect
JavaScript
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ă

Greșit
JavaScript
const rand = "Ana\t25"; // tab real
JSON.parse(`{"rand": "${rand}"}`);
Corect
JavaScript
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ă tu

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.

Codul care dă eroarea
JavaScript
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`);
După reparație, programul afișează
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.

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 data
  • SyntaxError: 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.stringify pe 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

← Toate erorile JavaScript

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.