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ă.
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
const clienti = [{ nume: "Ana" }, { nume: "Dan" }];
for (let i = 0; i <= clienti.length; i++) {
console.log(clienti[i].nume);
}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
const p = produse.find((x) => x.cod === "Z9");
console.log(p.nume);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
function gasesteClient(id) {
clienti.find((c) => c.id === id);
}
console.log(gasesteClient(1).nume);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ă
const oras = user.adresa.oras;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ă 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.
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);
}Ana Dan Ioana
Indiciu
Ultimul indice valid dintr-un tablou cu 3 elemente este 2.
Reparația
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);
}De ce merge
Tabloul are 3 elemente, cu indicii 0, 1 și 2. Condiția i <= clienti.length mai făcea un pas, cu i = 3, iar clienti[3] este undefined; citirea .nume din undefined a aruncat eroarea. Cu <, bucla se oprește la ultimul indice valid.
Și mai sigur: for (const c of clienti) console.log(c.nume);, unde nu mai calculezi deloc indicii.
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 undefinedTypeError: 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
findsau 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...ofsau metodele de tablou (map,forEach) în loc de indici calculați manual. - Afișează cu
console.logobiectul î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
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 set properties of undefined (setting 'cantitate') Î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. 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.
