SyntaxError: Unexpected token '', "{"nume":""... is not valid JSON
Fișierul JSON începe cu un caracter invizibil, BOM (U+FEFF), pus de unele editoare pe Windows, iar JSON.parse nu îl acceptă. Elimină-l după citire: fs.readFileSync(f, "utf8").replace(/^\uFEFF/, ""), apoi salvează fișierul ca „UTF-8” fără BOM.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Între ghilimelele Unexpected token '...' pare să nu fie nimic, dar acolo e un caracter invizibil: BOM (Byte Order Mark, U+FEFF). Unele programe (Notepad mai vechi, Excel la „CSV UTF-8”, PowerShell 5 cu Out-File, unele exporturi din aplicații) îl pun la începutul fișierelor text, ca semn că sunt în UTF-8.
fs.readFileSync(fisier, "utf8") păstrează caracterul în text, iar JSON.parse vede ca prim caracter ceva ce nu e nici {, nici [. Pe ecran fișierul arată perfect, de aceea eroarea e greu de înțeles.
Cum confirmi: afișează text.charCodeAt(0); dacă primești 65279, e BOM. În VS Code, colțul din dreapta jos arată „UTF-8 with BOM”. Interesant: require("./config.json") elimină singur BOM-ul, așa că eroarea apare doar când citești fișierul cu fs și îl parsezi tu.
De ce apare: cauzele frecvente
1Fișier salvat cu BOM, citit cu fs
const text = fs.readFileSync("config.json", "utf8");
const config = JSON.parse(text);const text = fs.readFileSync("config.json", "utf8").replace(/^\uFEFF/, "");
const config = JSON.parse(text);Expresia regulată elimină BOM-ul doar dacă e primul caracter; restul textului rămâne neschimbat.
2CSV exportat din Excel
const antet = text.split("\n")[0].split(",");
// antet[0] e "\uFEFFprodus", nu "produs"const curat = text.replace(/^\uFEFF/, "");
const antet = curat.split("\n")[0].split(",");Nu primești eroare, dar prima coloană are un nume diferit și rand.produs dă undefined. Aceeași curățare rezolvă și asta.
3Fișier generat de PowerShell
# PowerShell 5
$date | ConvertTo-Json | Out-File config.json -Encoding utf8# PowerShell 7 scrie implicit fără BOM
$date | ConvertTo-Json | Set-Content config.json -Encoding utf8NoBOMDacă tu generezi fișierul, oprește BOM-ul la sursă, ca să nu mai fie nevoie de curățare.
Repară eroarea, direct în pagină
Fișierul config.json a fost salvat pe Windows cu BOM, iar programul dă SyntaxError: Unexpected token '', ... is not valid JSON, deși conținutul arată corect. Elimină caracterul BOM de la începutul textului înainte de JSON.parse, ca programul să afișeze numele magazinului și portul.
const fs = require("fs");
const text = fs.readFileSync("config.json", "utf8");
const config = JSON.parse(text);
console.log(`Magazin: ${config.nume}`);
console.log(`Port: ${config.port}`);Magazin: Cafeneaua Verde Port: 3000
Indiciu
BOM-ul este caracterul \uFEFF; .replace(/^\uFEFF/, "") îl scoate doar de la început.
Reparația
const fs = require("fs");
const text = fs.readFileSync("config.json", "utf8").replace(/^\uFEFF/, "");
const config = JSON.parse(text);
console.log(`Magazin: ${config.nume}`);
console.log(`Port: ${config.port}`);De ce merge
fs.readFileSync cu "utf8" îți dă textul exact din fișier, inclusiv BOM-ul invizibil de la început. JSON.parse acceptă la început doar spații și începutul unei valori JSON, deci se oprește la primul caracter. .replace(/^\uFEFF/, "") elimină BOM-ul dacă există și nu schimbă nimic dacă lipsește, așa că funcționează pentru fișiere salvate în ambele feluri.
Alte forme ale mesajului
SyntaxError: Unexpected token '', "{ "nume"... is not valid JSONSyntaxError: Unexpected token in JSON at position 0SyntaxError: Unexpected token '', "[{"id":1,""... is not valid JSON
Cum o eviți pe viitor
- Salvează fișierele de date ca „UTF-8” simplu, nu „UTF-8 with BOM” (în VS Code: clic pe codare, „Save with Encoding”).
- Când citești fișiere venite de la alții (exporturi, uploaduri), elimină BOM-ul înainte de
JSON.parsesau de împărțirea pe linii. - Pune curățarea într-o funcție
citesteText(fisier)folosită peste tot în proiect.
Întrebări frecvente
De ce require() citește același fișier fără eroare?
Încărcătorul de module al lui Node elimină BOM-ul din fișierele .json și .js. fs.readFileSync îți dă însă conținutul exact, cu tot cu BOM.
Pot citi fișierul fără "utf8" ca să scap de BOM?
Nu. Fără codare primești un Buffer cu octeții EF BB BF la început, iar la conversia în text BOM-ul apare din nou. Trebuie eliminat explicit.
Erori înrudite
SyntaxError: /app/config.json: Expected double-quoted property name in JSON at position 59 (line 5 column 1) Fișierul JSON încărcat cu require are o greșeală de sintaxă: de obicei o virgulă după ultimul element, ghilimele simple sau un comentariu. Mesajul îți dă fișierul și linia; scoate virgula de la final și pune cheile între ghilimele duble. Error: ENOENT: no such file or directory, open 'date.txt' Fișierul pe care vrei să-l deschizi nu există la calea dată, sau dosarul în care vrei să scrii lipsește. Calea relativă pornește din dosarul din care rulezi node, nu din dosarul scriptului. Verifică calea, construiește-o cu path.join(__dirname, ...) și creează dosarul înainte de scriere. TypeError [ERR_UNKNOWN_ENCODING]: Unknown encoding: base-64 Numele codificării dat lui Buffer.from, toString sau unei funcții din fs nu e recunoscut de Node: de obicei e scris cu cratimă sau greșit, de exemplu "base-64" sau "utf-16". Folosește numele acceptate: "utf8", "base64", "base64url", "hex", "latin1", "utf16le", "ascii". Învață Node.js de la zero, cu exerciții la fiecare lecție
Curs Node.js: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
