...
Eroare JavaScript · Valori undefined și null

TypeError: Cannot read properties of undefined (reading 'nume')

Pe scurt

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

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

Ce înseamnă

Cea mai frecventă eroare din JavaScript. Citește-o așa: în expresia ceva.nume, ceva este undefined, iar din undefined nu poți citi nimic. Numele din paranteză, (reading 'nume'), este proprietatea pe care încercai să o citești, nu variabila care e undefined. Variabila e cea din stânga punctului.

Într-un lanț ca comanda.client.adresa.oras, mesajul (reading 'oras') îți spune că comanda.client.adresa este undefined. Mergi înapoi pe lanț și afișează fiecare bucată cu console.log până găsești prima care lipsește.

De unde vine undefined: un index în afara tabloului (lista[5] dintr-un tablou de 3), o proprietate scrisă diferit (user.Nume în loc de user.nume), o funcție fără return, find care nu a găsit nimic, un parametru care nu a fost trimis, sau date asincrone folosite înainte să sosească. Stiva de apeluri arată linia exactă.

De ce apare: cauzele frecvente

1Index în afara tabloului

Greșit
JavaScript
const clienti = [{ nume: "Ana" }, { nume: "Dan" }];
for (let i = 0; i <= clienti.length; i++) {
  console.log(clienti[i].nume);
}
Corect
JavaScript
const clienti = [{ nume: "Ana" }, { nume: "Dan" }];
for (let i = 0; i < clienti.length; i++) {
  console.log(clienti[i].nume);
}

Indicii merg de la 0 la length - 1. Cu <=, ultimul pas citește clienti[2], care e undefined.

2find nu a găsit nimic

Greșit
JavaScript
const p = produse.find((x) => x.cod === "Z9");
console.log(p.nume);
Corect
JavaScript
const p = produse.find((x) => x.cod === "Z9");
console.log(p ? p.nume : "Produs inexistent");

find returnează undefined când niciun element nu se potrivește. Verifică rezultatul înainte să îl folosești.

3Funcție care uită return

Greșit
JavaScript
function gasesteClient(id) {
  clienti.find((c) => c.id === id);
}
console.log(gasesteClient(1).nume);
Corect
JavaScript
function gasesteClient(id) {
  return clienti.find((c) => c.id === id);
}
console.log(gasesteClient(1).nume);

O funcție fără return returnează undefined. La funcțiile cu acolade, return e obligatoriu.

4Proprietate imbricată opțională

Greșit
JavaScript
const oras = user.adresa.oras;
Corect
JavaScript
const oras = user.adresa?.oras ?? "necunoscut";

Dacă lipsa adresei este o situație normală, ?. oprește lanțul și dă undefined în loc de eroare, iar ?? pune o valoare implicită.

Repară tu

Repară eroarea, direct în pagină

Programul de mai jos ar trebui să afișeze numele fiecărui client din listă, dar după ultimul nume se oprește cu TypeError: Cannot read properties of undefined (reading 'nume'). Repară bucla ca să afișeze cele trei nume, fără eroare.

Codul care dă eroarea
JavaScript
const clienti = [
  { nume: "Ana", oras: "Iași" },
  { nume: "Dan", oras: "Cluj" },
  { nume: "Ioana", oras: "Brașov" }
];

for (let i = 0; i <= clienti.length; i++) {
  console.log(clienti[i].nume);
}
După reparație, programul afișează
Ana
Dan
Ioana
Indiciu

Ultimul indice valid dintr-un tablou cu 3 elemente este 2.

Alte forme ale mesajului

  • TypeError: Cannot read properties of undefined (reading 'length')
  • TypeError: Cannot read properties of undefined (reading 'map')
  • TypeError: Cannot read property 'nume' of undefined
  • TypeError: undefined is not an object (evaluating 'user.nume')

Cum o eviți pe viitor

  • Înainte să citești dintr-un obiect primit de la o funcție, din find sau din date externe, întreabă-te: poate lipsi?
  • Dacă poate lipsi în mod normal, folosește ?. și ??. Dacă nu ar trebui să lipsească, verifică explicit și aruncă o eroare clară.
  • Folosește for...of sau metodele de tablou (map, forEach) în loc de indici calculați manual.
  • Afișează cu console.log obiectul întreg când nu ești sigur de structura lui.

Întrebări frecvente

Numele din paranteză e variabila undefined?

Nu. (reading 'nume') e proprietatea pe care voiai să o citești. Valoarea undefined este cea din stânga lui .nume.

De ce în Safari mesajul e diferit?

Fiecare browser are motorul lui. Safari spune undefined is not an object (evaluating 'user.nume'), versiunile vechi de Chrome spuneau Cannot read property 'nume' of undefined. Cauza e aceeași.

Să pun ?. peste tot?

Nu. ?. ascunde eroarea, deci folosește-l doar unde lipsa valorii e o situație normală. Altfel ai un undefined care merge mai departe și strică alt calcul.

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.