TypeError: Cannot convert undefined or null to object
Ai dat `undefined` sau `null` unei funcții care are nevoie de un obiect: `Object.keys`, `Object.values`, `Object.entries`, `Object.assign` sau `for...in` pe ceva care lipsește. Verifică de unde vine valoarea sau folosește un obiect gol ca rezervă: `Object.keys(date ?? {})`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Metodele statice ale lui Object (keys, values, entries, assign, getOwnPropertyNames) încep prin a-și converti argumentul la obiect. Un număr sau un text pot fi convertite (Object.keys("abc") dă ["0", "1", "2"]), dar undefined și null nu pot, deci primești Cannot convert undefined or null to object.
Mesajul nu spune ce variabilă era goală, așa că uită-te la linia din stiva de apeluri: de obicei e un apel Object.keys(x) sau Object.entries(x) unde x vine dintr-o proprietate care lipsește (raport.categorii, cu categorie scris altfel), dintr-o funcție fără return sau dintr-un JSON cu valoare null.
O variantă mai ascunsă: Object.assign(null, ...) sau spread-ul unei valori într-o funcție care se așteaptă la obiect. Spread-ul în obiecte literale ({ ...undefined }) nu dă eroare, ci un obiect gol.
De ce apare: cauzele frecvente
1Proprietate scrisă greșit, deci undefined
const raport = { vanzari: { ian: 10, feb: 12 } };
console.log(Object.keys(raport.vanzare));const raport = { vanzari: { ian: 10, feb: 12 } };
console.log(Object.keys(raport.vanzari));raport.vanzare nu există, deci e undefined, iar Object.keys nu poate lucra cu el.
2Câmp opțional, care poate lipsi
for (const [k, v] of Object.entries(user.setari)) {
console.log(k, v);
}for (const [k, v] of Object.entries(user.setari ?? {})) {
console.log(k, v);
}Dacă lipsa setărilor e normală, ?? {} transformă cazul într-o buclă care nu face nimic.
3Funcție care nu returnează obiectul
function config() {
const c = { tema: "dark" };
}
Object.keys(config());function config() {
return { tema: "dark" };
}
Object.keys(config());Fără return, funcția dă undefined.
Repară eroarea, direct în pagină
Programul de mai jos afișează vânzările pe luni dintr-un raport, dar se oprește cu TypeError: Cannot convert undefined or null to object. Repară programul ca să afișeze fiecare lună cu valoarea ei.
const raport = {
an: 2026,
vanzariLunare: { ianuarie: 1200, februarie: 950, martie: 1430 }
};
for (const [luna, valoare] of Object.entries(raport.vanzari)) {
console.log(`${luna}: ${valoare} lei`);
}ianuarie: 1200 lei februarie: 950 lei martie: 1430 lei
Indiciu
Compară numele proprietății din obiect cu cel folosit la Object.entries.
Reparația
const raport = {
an: 2026,
vanzariLunare: { ianuarie: 1200, februarie: 950, martie: 1430 }
};
for (const [luna, valoare] of Object.entries(raport.vanzariLunare)) {
console.log(`${luna}: ${valoare} lei`);
}De ce merge
Obiectul are proprietatea vanzariLunare, nu vanzari. Citirea unei proprietăți care nu există nu dă eroare, ci undefined, iar abia Object.entries(undefined) a aruncat-o, pentru că nu poate transforma undefined într-un obiect. Cu numele corect, Object.entries returnează perechile [luna, valoare] în ordinea în care au fost scrise.
Alte forme ale mesajului
TypeError: Cannot convert undefined or null to object at Function.keysTypeError: Cannot convert undefined or null to object at Function.entriesTypeError: Cannot convert undefined or null to object at Function.assign
Cum o eviți pe viitor
- Când datele vin din exterior (JSON, API, formular), validează structura înainte de a o parcurge.
- Pentru câmpuri opționale, folosește o rezervă:
Object.entries(x ?? {}). - Folosește nume de proprietăți consecvente și autocompletarea editorului.
- Afișează cu
console.logobiectul întreg când nu ești sigur ce chei are.
Întrebări frecvente
De ce { ...undefined } nu dă eroare, dar Object.keys(undefined) dă?
Spread-ul în obiecte literale ignoră intenționat null și undefined. Object.keys cere o valoare care poate fi convertită la obiect, iar acestea două nu pot.
Cum aflu ce variabilă era goală?
Mergi la linia din stiva de apeluri și afișează argumentul cu console.log chiar înainte de apel. Mesajul în sine nu îl numește.
Erori înrudite
TypeError: Cannot read properties of undefined (reading 'nume') Încerci să citești o proprietate (aici `nume`) dintr-o valoare care este `undefined`, adică dintr-un obiect care nu există. De obicei un element de tablou care lipsește, o proprietate scrisă greșit sau o funcție care nu returnează nimic. Află de ce valoarea e `undefined` sau folosește `?.` dacă lipsa e normală. TypeError: Cannot read properties of null (reading 'textContent') Citești o proprietate dintr-o valoare `null`. În browser, aproape mereu e un element pe care `document.querySelector` sau `getElementById` nu l-a găsit (selector greșit sau script rulat înainte ca elementul să existe). În rest, o funcție sau o metodă a returnat `null` intenționat: verifică rezultatul înainte să îl folosești. TypeError: Cannot destructure property 'nume' of 'undefined' as it is undefined. Faci destructurare (`const { nume } = ...` sau `function f({ nume })`) dintr-o valoare `undefined`. De obicei funcția a fost apelată fără argument sau obiectul nu există. Trimite obiectul ori pune o valoare implicită: `function f({ nume } = {})`. Învață JavaScript de la zero, cu exerciții la fiecare lecție
Curs JavaScript: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
