TypeError: Cannot convert undefined or null to object
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
const [stoc, setStoc] = useState();
Object.entries(stoc).map(([p, n]) => <li key={p}>{p}: {n}</li>)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
function Tabel({ date }) {
return Object.keys(date).map((k) => <td key={k}>{k}</td>);
}
<Tabel />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
const [user, setUser] = useState(null);
const campuri = Object.keys(user);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ă 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”.
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.
Reparația
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>
);
}De ce merge
La prima randare fetch nu a terminat încă, deci stoc este undefined, iar Object.entries(undefined) aruncă eroarea și oprește componenta înainte ca datele să sosească.
Cu useState({}), prima randare lucrează pe un obiect gol: Object.entries({}) dă un tablou gol, deci lista e goală, dar fără eroare. După răspuns, setStoc pune obiectul primit, iar React randează câte un li pentru fiecare pereche produs: bucăți.
Alte forme ale mesajului
TypeError: can't convert undefined to objectTypeError: can't convert null to objectTypeError: 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
TypeError: Cannot read properties of undefined (reading 'map') Apelezi .map pe o variabilă care este undefined, de obicei pentru că datele nu s-au încărcat încă sau prop-ul nu a fost trimis. Pornește state-ul cu un tablou gol, useState([]), sau verifică variabila înainte de map. TypeError: Cannot read properties of null (reading 'nume') Citești un câmp dintr-un obiect care încă este null, de obicei date care se încarcă în useEffect, dar sunt afișate deja la prima randare. Afișează o stare de încărcare până vin datele: if (!utilizator) return .... Objects are not valid as a React child (found: object with keys {nume, email}). If you meant to render a collection of children, use an array instead. Ai pus un obiect întreg între acolade în JSX, iar React nu știe să-l afișeze. Afișează o proprietate a lui ({utilizator.nume}), transformă-l în text sau, la un tablou de obiecte, folosește map. Î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.
