...
Eroare React · Ce poți afișa în JSX

TypeError: Cannot convert undefined or null to object

Pe scurt

Ai apelat Object.keys, Object.entries, Object.values sau Object.assign pe o valoare undefined sau null, de obicei date care încă nu au venit sau un prop care nu a fost trimis. Pornește state-ul cu {} sau verifică valoarea înainte de apel.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Funcțiile Object.keys(), Object.values(), Object.entries() și Object.assign() primesc un obiect. Dacă le dai undefined sau null, JavaScript nu are ce transforma în obiect și aruncă această eroare.

În React apare tipic când afișezi un obiect ca listă (Object.entries(stoc).map(...)) și obiectul încă nu există: state-ul a pornit cu useState() sau useState(null), iar datele vin abia după un fetch. Apare și când un prop nu e trimis de părinte (<Tabel date={...}> uitat) sau când numele câmpului din răspunsul serverului e altul decât crezi.

Stack trace-ul arată componenta și linia cu Object.*. Pune acolo un console.log al valorii ca să vezi dacă e undefined (lipsește) sau null (încă nu a venit).

De ce apare: cauzele frecvente

1State pornit fără obiect

Greșit
JSX
const [stoc, setStoc] = useState();
Object.entries(stoc).map(([p, n]) => <li key={p}>{p}: {n}</li>)
Corect
JSX
const [stoc, setStoc] = useState({});
Object.entries(stoc).map(([p, n]) => <li key={p}>{p}: {n}</li>)

Un obiect gol dă o listă goală, iar componenta se randează fără eroare până sosesc datele.

2Prop care lipsește

Greșit
JSX
function Tabel({ date }) {
  return Object.keys(date).map((k) => <td key={k}>{k}</td>);
}
<Tabel />
Corect
JSX
function Tabel({ date = {} }) {
  return Object.keys(date).map((k) => <td key={k}>{k}</td>);
}
<Tabel />

O valoare implicită pentru prop protejează componenta când părintele nu îl trimite.

3Date care pot fi null

Greșit
JSX
const [user, setUser] = useState(null);
const campuri = Object.keys(user);
Corect
JSX
const [user, setUser] = useState(null);
const campuri = user ? Object.keys(user) : [];

Când null e o stare reală („încă nu am date”), verifică-l înainte de a lucra cu obiectul.

Repară tu

Repară eroarea, direct în pagină

Componenta de mai jos încarcă stocul magazinului cu fetch și îl afișează ca listă, dar la prima randare dă eroarea „Cannot convert undefined or null to object”. Repar-o ca, după încărcare, să apară câte un li pentru fiecare produs, de forma „Cană: 12”.

Codul care dă eroarea
JSX
import { useState, useEffect } from "react";

export default function App() {
  const [stoc, setStoc] = useState();

  useEffect(() => {
    fetch("https://api.exemplu.ro/stoc")
      .then((r) => r.json())
      .then((date) => setStoc(date));
  }, []);

  return (
    <ul>
      {Object.entries(stoc).map(([produs, buc]) => (
        <li key={produs}>{produs}: {buc}</li>
      ))}
    </ul>
  );
}
Indiciu

Pornește state-ul cu un obiect gol.

Alte forme ale mesajului

  • TypeError: can't convert undefined to object
  • TypeError: can't convert null to object
  • TypeError: Requested keys of a value that is not an object.

Cum o eviți pe viitor

  • Pornește state-ul cu forma pe care o vor avea datele: {} pentru obiecte, [] pentru liste.
  • Dă valori implicite props-urilor de tip obiect: function Tabel({ date = {} }).
  • Pentru date care pot fi null, afișează mai întâi starea de încărcare și abia apoi lista.
  • Poți scrie și Object.keys(date ?? {}) când vrei o protecție scurtă.

Întrebări frecvente

De ce merge după un refresh sau după o secundă?

Pentru că la prima randare datele nu au venit încă. Componenta se randează o dată înainte de fetch, iar atunci obiectul este undefined sau null.

E la fel cu „Cannot read properties of undefined”?

Cauza este aceeași (o valoare lipsă), dar apare în alt loc: aici la o funcție Object.*, acolo la citirea unei proprietăți cu punct.

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.