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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
În JSON, backslash-ul (\) începe o secvență de escape, iar lista celor permise e scurtă: \", \\, \/, \b, \f, \n, \r, \t și \uXXXX. Orice altceva după backslash, de exemplu \P din C:\Proiecte, \' sau \x41, e invalid, iar JSON.parse aruncă această eroare, cu poziția caracterului de după backslash.
Situații tipice:
- căi Windows scrise cu un singur backslash într-un fișier de configurare JSON;
\'pentru apostrof, valid în JavaScript, dar nu și în JSON (acolo apostroful nu se escapează);- texte trecute prin două sisteme care au escapat diferit;
\uurmat de mai puțin de patru cifre hexa, cu mesajulBad Unicode escape in JSON.
Atenție la nivelurile de escape: într-un text JavaScript obișnuit, "C:\\dir" ajunge în JSON ca C:\dir, adică tot greșit. Pentru JSON corect ai nevoie de patru backslash-uri în sursă sau de String.raw cu două.
De ce apare: cauzele frecvente
1Cale Windows cu un singur backslash
const cfg = String.raw`{"folder": "C:\Proiecte"}`;
JSON.parse(cfg);const cfg = String.raw`{"folder": "C:\\Proiecte"}`;
JSON.parse(cfg);În JSON, un backslash literal se scrie dublat: \\.
2Apostrof escapat ca în JavaScript
JSON.parse(String.raw`{"text": "it\'s"}`);JSON.parse(String.raw`{"text": "it's"}`);Apostroful nu are nevoie de escape în JSON; doar ghilimelele duble au.
3JSON scris de mână în loc de generat
const json = '{"cale": "' + cale + '"}';const json = JSON.stringify({ cale });JSON.stringify dublează singur backslash-urile din cale.
Repară eroarea, direct în pagină
Programul citește dintr-un JSON folderul proiectului, o cale Windows, dar se oprește cu SyntaxError: Bad escaped character in JSON. Repară textul JSON ca programul să afișeze Folder: C:\Proiecte\magazin.
const config = String.raw`{"folder": "C:\Proiecte\magazin"}`;
const setari = JSON.parse(config);
console.log(`Folder: ${setari.folder}`);Folder: C:\Proiecte\magazin
Indiciu
Textul e scris cu String.raw, deci ce vezi ajunge exact așa la JSON.parse; în JSON, un backslash se scrie de două ori.
Reparația
const config = String.raw`{"folder": "C:\\Proiecte\\magazin"}`;
const setari = JSON.parse(config);
console.log(`Folder: ${setari.folder}`);De ce merge
String.raw păstrează backslash-urile exact cum sunt scrise, deci JSON.parse primea C:\Proiecte, unde \P nu e o secvență de escape validă în JSON. Cu \\ în text, JSON-ul conține un backslash escapat corect, iar după parsare valoarea are un singur backslash între componente: C:\Proiecte\magazin.
Alte forme ale mesajului
SyntaxError: Bad Unicode escape in JSON at position 11 (line 1 column 12)SyntaxError: JSON.parse: bad escaped character at line 1 column 14 of the JSON dataSyntaxError: Bad escaped character in JSON at position 13
Cum o eviți pe viitor
- Generează JSON doar cu
JSON.stringify; nu concatena texte. - În fișiere de configurare, scrie căile Windows cu
/(C:/Proiecte), pe care Windows le acceptă, sau cu\\. - Folosește un editor care validează fișierele
.jsonși subliniază escape-urile greșite. - Când un text trece prin mai multe sisteme, verifică la fiecare pas cine îl escapează.
Întrebări frecvente
De ce "C:\new" nu dă eroare, dar dă un rezultat ciudat?
\n e o secvență validă (linie nouă), deci JSON-ul se parsează, dar calea conține acum un Enter în loc de \n. E o greșeală mai periculoasă, pentru că nu o vezi imediat.
\/ e necesar în JSON?
Nu, e doar permis. JSON.stringify nu escapează slash-ul, iar "a/b" e JSON valid.
Erori înrudite
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. SyntaxError: Invalid Unicode escape sequence Într-un șir ai un backslash urmat de `u` care nu formează un cod Unicode valid, cel mai des într-o cale Windows ca `"C:\users\ana"`. Backslash-ul începe o secvență escape. Dublează-l (`\\`), folosește `/` sau `String.raw`. SyntaxError: Expected property name or '}' in JSON at position 1 (line 1 column 2) Textul dat lui `JSON.parse` arată ca un obiect JavaScript, nu ca JSON: cheile nu sunt între ghilimele duble (`{nume: "Ana"}`) sau sunt între ghilimele simple (`{'nume': 'Ana'}`). În JSON, cheile și textele se scriu obligatoriu cu ghilimele duble. Generează JSON-ul cu `JSON.stringify`. Î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.
