SyntaxError: "undefined" is not valid JSON
JSON.parse a primit textul "undefined", de obicei citit din localStorage după ce ai salvat o valoare undefined (localStorage.setItem("cos", undefined)). Nu salva valori lipsă, salvează mereu cu JSON.stringify și verifică textul înainte de JSON.parse.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
JSON.parse primește un text și îl transformă în date. Textul "undefined" nu este JSON valid (JSON cunoaște null, dar nu undefined), așa că funcția aruncă această eroare.
De unde vine textul? localStorage și sessionStorage salvează doar texte: localStorage.setItem("cos", undefined) salvează literalmente cuvântul „undefined”. La următoarea deschidere a paginii, codul care face JSON.parse(localStorage.getItem("cos")) crapă chiar la pornirea aplicației.
Cauze frecvente: salvezi un state care încă nu are valoare, scrii JSON.stringify(undefined) (care întoarce undefined, nu un text), sau salvezi greșit o proprietate inexistentă (setItem("user", date.user) când date.user lipsește). Dacă eroarea rămâne după ce repari codul, șterge cheia veche din Application → Local Storage.
De ce apare: cauzele frecvente
1Valoare lipsă salvată în localStorage
localStorage.setItem("cos", cos);
// cos este undefinedlocalStorage.setItem("cos", JSON.stringify(cos ?? []));Cu o valoare implicită, în localStorage ajunge mereu un JSON valid, de exemplu [].
2Citire fără verificare
const cos = JSON.parse(localStorage.getItem("cos"));const text = localStorage.getItem("cos");
const cos = text && text !== "undefined" ? JSON.parse(text) : [];Verifici textul înainte de JSON.parse, ca o valoare stricată din trecut să nu oprească aplicația.
3Inițializare sigură cu try/catch
const [cos, setCos] = useState(JSON.parse(localStorage.getItem("cos")));function citesteCos() {
try {
return JSON.parse(localStorage.getItem("cos")) ?? [];
} catch {
return [];
}
}
const [cos, setCos] = useState(citesteCos);Orice text invalid din storage duce la valoarea implicită, nu la o pagină albă.
Repară eroarea, direct în pagină
Componenta de mai jos salvează în localStorage tema aleasă, dar nu pornește: dă eroarea „"undefined" is not valid JSON”. Repar-o ca, la deschidere, paragraful #tema să afișeze „light”, iar după click pe #comuta să afișeze „dark”.
import { useState, useEffect } from "react";
localStorage.setItem("setari", undefined);
function citesteSetari() {
return JSON.parse(localStorage.getItem("setari"));
}
export default function App() {
const [setari, setSetari] = useState(citesteSetari);
useEffect(() => {
localStorage.setItem("setari", setari);
}, [setari]);
return (
<div>
<p id="tema">{setari ? setari.tema : "light"}</p>
<button id="comuta" onClick={() => setSetari({ tema: "dark" })}>Comută</button>
</div>
);
}Indiciu
Salvează cu JSON.stringify și pune o valoare implicită la citire.
Reparația
import { useState, useEffect } from "react";
localStorage.setItem("setari", undefined);
function citesteSetari() {
try {
return JSON.parse(localStorage.getItem("setari")) ?? { tema: "light" };
} catch {
return { tema: "light" };
}
}
export default function App() {
const [setari, setSetari] = useState(citesteSetari);
useEffect(() => {
localStorage.setItem("setari", JSON.stringify(setari));
}, [setari]);
return (
<div>
<p id="tema">{setari.tema}</p>
<button id="comuta" onClick={() => setSetari({ tema: "dark" })}>Comută</button>
</div>
);
}De ce merge
Linia de sus simulează o valoare stricată, rămasă de la o rulare anterioară: setItem("setari", undefined) salvează textul „undefined”. JSON.parse nu îl poate citi, așa că aplicația crapă înainte de prima randare.
Citirea cu try/catch revine la { tema: "light" } când textul nu e JSON valid. Salvarea cu JSON.stringify scrie de acum mereu un JSON corect, deci la următoarea deschidere JSON.parse va funcționa.
Alte forme ale mesajului
SyntaxError: Unexpected token u in JSON at position 0SyntaxError: JSON Parse error: Unexpected identifier "undefined"
Cum o eviți pe viitor
- Salvează mereu cu
JSON.stringifyși citește mereu cuJSON.parse, în aceeași pereche. - Pune o valoare implicită când salvezi (
cos ?? []) și când citești. - Învelește citirea din storage într-o funcție cu
try/catch; datele din browser pot fi vechi sau modificate de mână. - Pentru teste, golește storage-ul din DevTools (Application → Local Storage).
Întrebări frecvente
De ce JSON.parse(null) nu dă eroare, dar "undefined" da?
getItem întoarce null când cheia nu există, iar JSON.parse(null) dă tot null. Textul „undefined” însă este un cuvânt pe care formatul JSON nu îl cunoaște.
Am reparat codul, dar eroarea a rămas. De ce?
Textul greșit e încă salvat în browser din rularea anterioară. Șterge cheia din DevTools sau adaugă o citire cu try/catch care revine la o valoare implicită.
Erori înrudite
SyntaxError: "[object Object]" is not valid JSON JSON.parse a primit textul "[object Object]": ai salvat un obiect în localStorage (sau l-ai lipit la un text) fără JSON.stringify. Salvează obiectele cu JSON.stringify(obiect) și citește-le cu JSON.parse; nu face JSON.parse pe ceva care e deja obiect. SyntaxError: Unexpected token '<', "<!DOCTYPE "... is not valid JSON Ai apelat res.json() pe un răspuns care este HTML, nu JSON: de obicei adresa API-ului e greșită și serverul a trimis o pagină (index.html sau 404). Verifică adresa și res.ok înainte de res.json(). React Hook useEffect has a missing dependency: 'id'. Either include it or remove the dependency array. Efectul folosește o valoare (prop sau state) care lipsește din lista de dependențe, deci nu rulează din nou când ea se schimbă. Adaug-o în listă: useEffect(() => {...}, [id]). Învață React de la zero, cu exerciții la fiecare lecție
Curs React: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
