...
Eroare React · useEffect și încărcarea datelor

SyntaxError: "undefined" is not valid JSON

Pe scurt

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

Greșit
JSX
localStorage.setItem("cos", cos);
// cos este undefined
Corect
JSX
localStorage.setItem("cos", JSON.stringify(cos ?? []));

Cu o valoare implicită, în localStorage ajunge mereu un JSON valid, de exemplu [].

2Citire fără verificare

Greșit
JSX
const cos = JSON.parse(localStorage.getItem("cos"));
Corect
JSX
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

Greșit
JSX
const [cos, setCos] = useState(JSON.parse(localStorage.getItem("cos")));
Corect
JSX
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ă tu

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

Codul care dă eroarea
JSX
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.

Alte forme ale mesajului

  • SyntaxError: Unexpected token u in JSON at position 0
  • SyntaxError: JSON Parse error: Unexpected identifier "undefined"

Cum o eviți pe viitor

  • Salvează mereu cu JSON.stringify și citește mereu cu JSON.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

← Toate erorile React

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