...
Eroare Node.js · Fișiere și căi: fs și path

SyntaxError: Unexpected token '', "{"nume":""... is not valid JSON

Pe scurt

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

Greșit
JavaScript
const text = fs.readFileSync("config.json", "utf8");
const config = JSON.parse(text);
Corect
JavaScript
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

Greșit
JavaScript
const antet = text.split("\n")[0].split(",");
// antet[0] e "\uFEFFprodus", nu "produs"
Corect
JavaScript
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

Greșit
JavaScript
# PowerShell 5
$date | ConvertTo-Json | Out-File config.json -Encoding utf8
Corect
JavaScript
# PowerShell 7 scrie implicit fără BOM
$date | ConvertTo-Json | Set-Content config.json -Encoding utf8NoBOM

Dacă tu generezi fișierul, oprește BOM-ul la sursă, ca să nu mai fie nevoie de curățare.

Repară tu

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.

Codul care dă eroarea
JavaScript
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}`);
După reparație, programul afișează
Magazin: Cafeneaua Verde
Port: 3000
Indiciu

BOM-ul este caracterul \uFEFF; .replace(/^\uFEFF/, "") îl scoate doar de la început.

Alte forme ale mesajului

  • SyntaxError: Unexpected token '', "{ "nume"... is not valid JSON
  • SyntaxError: Unexpected token  in JSON at position 0
  • SyntaxError: 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.parse sau 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

← Toate erorile Node.js

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ță 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.