...
Eroare JavaScript · Valori undefined și null

TypeError: Cannot set properties of undefined (setting 'cantitate')

Pe scurt

Încerci să scrii o proprietate (aici `cantitate`) într-o valoare `undefined`, adică într-un obiect care nu există încă. De obicei obiectul intermediar nu a fost creat (`stoc[cod].cantitate = 1` când `stoc[cod]` lipsește) sau indexul tabloului e greșit. Creează obiectul înainte să îi setezi proprietăți.

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

Ce înseamnă

Este perechea erorii de citire: în ceva.cantitate = 5, ceva este undefined, deci nu există niciun obiect în care să fie scrisă proprietatea. Numele din paranteză, (setting 'cantitate'), e proprietatea pe care încercai să o setezi.

Cazul tipic apare când construiești un obiect pas cu pas, de exemplu un inventar pe categorii sau un total pe clienți: rezultat[categorie].total += pret. Prima dată când apare o categorie, rezultat[categorie] nu există, deci e undefined. JavaScript nu creează automat obiectele intermediare.

Alte cauze: index greșit într-un tablou de obiecte (comenzi[3].status = ... când sunt doar 3), sau this care e undefined într-o funcție apelată fără obiect (în strict mode).

De ce apare: cauzele frecvente

1Obiectul intermediar nu a fost creat

Greșit
JavaScript
const stoc = {};
stoc["lapte"].cantitate = 10;
Corect
JavaScript
const stoc = {};
stoc["lapte"] = { cantitate: 10 };
// sau: stoc["lapte"] ??= {}; stoc["lapte"].cantitate = 10;

stoc["lapte"] nu există încă. Creează întâi obiectul, apoi setează proprietăți pe el.

2Grupare fără inițializare

Greșit
JavaScript
for (const t of tranzactii) {
  ultima[t.categorie].suma = t.suma;
}
Corect
JavaScript
for (const t of tranzactii) {
  ultima[t.categorie] ??= {};
  ultima[t.categorie].suma = t.suma;
}

??= creează obiectul doar dacă lipsește. Atenție: cu += în loc de =, motorul citește întâi valoarea veche și mesajul devine Cannot read properties of undefined.

3Index în afara tabloului

Greșit
JavaScript
const comenzi = [{}, {}, {}];
comenzi[3].status = "trimisă";
Corect
JavaScript
const comenzi = [{}, {}, {}];
comenzi[2].status = "trimisă";
// sau comenzi.push({ status: "trimisă" });

Ultimul element al unui tablou cu 3 elemente are indicele 2. Pentru un element nou folosește push.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos calculează câte bucăți s-au vândut din fiecare produs, pe baza unei liste de vânzări, dar se oprește cu TypeError: Cannot set properties of undefined (setting 'bucati'). Repară codul ca să afișeze totalul pentru fiecare produs.

Codul care dă eroarea
JavaScript
const vanzari = [
  { produs: "cafea", bucati: 2 },
  { produs: "ceai", bucati: 1 },
  { produs: "cafea", bucati: 3 }
];

const vandute = {};
for (const v of vanzari) {
  if (!("bucati" in vandute)) {
    vandute[v.produs].bucati = 0;
  }
  vandute[v.produs].bucati += v.bucati;
}

for (const [produs, info] of Object.entries(vandute)) {
  console.log(`${produs}: ${info.bucati}`);
}
După reparație, programul afișează
cafea: 5
ceai: 1
Indiciu

Prima dată când apare un produs, vandute[v.produs] nu există. Creează-l înainte de adunare.

Alte forme ale mesajului

  • TypeError: Cannot set property 'cantitate' of undefined
  • TypeError: Cannot set properties of null (setting 'innerHTML')

Cum o eviți pe viitor

  • Când construiești un obiect pe chei, inițializează fiecare cheie la prima apariție (??=, if (!obj[k]) obj[k] = ...).
  • Pentru grupări, reduce cu un obiect inițial clar sau un Map fac codul mai ușor de urmărit.
  • Adaugă elemente noi în tablouri cu push, nu scriind la un index calculat.
  • Pentru numărări simple, (obj[k] ?? 0) + 1 evită obiectele intermediare.

Întrebări frecvente

De ce obj.a = 1 merge, dar obj.a.b = 1 nu?

obj.a = 1 creează proprietatea a pe un obiect existent. obj.a.b = 1 încearcă să scrie în obj.a, care încă nu există. JavaScript nu creează automat nivelurile intermediare.

Ce face ??=?

x ??= valoare atribuie doar dacă x este null sau undefined. E ideal pentru a inițializa o cheie la prima folosire.

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.