...
Eroare JavaScript · Valori undefined și null

TypeError: Cannot convert undefined or null to object

Pe scurt

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

Greșit
JavaScript
const raport = { vanzari: { ian: 10, feb: 12 } };
console.log(Object.keys(raport.vanzare));
Corect
JavaScript
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

Greșit
JavaScript
for (const [k, v] of Object.entries(user.setari)) {
  console.log(k, v);
}
Corect
JavaScript
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

Greșit
JavaScript
function config() {
  const c = { tema: "dark" };
}
Object.keys(config());
Corect
JavaScript
function config() {
  return { tema: "dark" };
}
Object.keys(config());

Fără return, funcția dă undefined.

Repară tu

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.

Codul care dă eroarea
JavaScript
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`);
}
După reparație, programul afișează
ianuarie: 1200 lei
februarie: 950 lei
martie: 1430 lei
Indiciu

Compară numele proprietății din obiect cu cel folosit la Object.entries.

Alte forme ale mesajului

  • TypeError: Cannot convert undefined or null to object at Function.keys
  • TypeError: Cannot convert undefined or null to object at Function.entries
  • TypeError: 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.log obiectul î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

← Toate erorile JavaScript

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