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 } = {})`.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Destructurarea scoate proprietăți dintr-un obiect direct în variabile: const { nume, oras } = client. Ca să facă asta, are nevoie de un obiect. Dacă în dreapta e undefined (sau null), nu are de unde extrage nume, iar mesajul îți spune exact asta: proprietatea nume nu poate fi extrasă din undefined.
Cel mai des apare la parametrii destructurați: function afiseaza({ nume, varsta }) apelată ca afiseaza(), fără argument. Parametrul e undefined, iar destructurarea lui aruncă eroarea chiar la intrarea în funcție.
Alte cazuri: rezultatul unui find care nu a găsit nimic, o proprietate imbricată care lipsește (const { oras } = client.adresa), un element de tablou care nu există. Dacă valoarea e null, mesajul spune of 'null' as it is null.
De ce apare: cauzele frecvente
1Funcție cu parametru destructurat, apelată fără argument
function salut({ nume }) {
return `Salut, ${nume}`;
}
salut();function salut({ nume = "vizitator" } = {}) {
return `Salut, ${nume}`;
}
salut();= {} dă parametrului un obiect gol când lipsește, iar nume = "vizitator" o valoare implicită pentru proprietate.
2Destructurare din rezultatul lui find
const { pret } = produse.find((p) => p.cod === "X");const produs = produse.find((p) => p.cod === "X");
const pret = produs ? produs.pret : 0;find dă undefined dacă nu găsește nimic. Verifică rezultatul înainte să îl destructurezi.
3Nivel imbricat care lipsește
const { oras } = client.adresa;const { oras } = client.adresa ?? {};?? {} înlocuiește lipsa adresei cu un obiect gol, iar oras devine undefined în loc de eroare.
Repară eroarea, direct în pagină
Funcția de mai jos afișează un mesaj de bun venit și primește opțiunile ca obiect destructurat. Al doilea apel nu trimite nimic și programul se oprește cu TypeError: Cannot destructure property 'nume' of 'undefined' as it is undefined.. Repară funcția (nu apelurile) ca fără argument să salute un vizitator în limba ro.
function bunVenit({ nume, limba }) {
const salut = limba === "en" ? "Welcome" : "Bun venit";
console.log(`${salut}, ${nume}!`);
}
bunVenit({ nume: "Maria", limba: "en" });
bunVenit();Welcome, Maria! Bun venit, vizitator!
Indiciu
Poți da o valoare implicită întregului parametru și fiecărei proprietăți.
Reparația
function bunVenit({ nume = "vizitator", limba = "ro" } = {}) {
const salut = limba === "en" ? "Welcome" : "Bun venit";
console.log(`${salut}, ${nume}!`);
}
bunVenit({ nume: "Maria", limba: "en" });
bunVenit();De ce merge
La apelul bunVenit() parametrul este undefined, iar destructurarea { nume, limba } nu are din ce obiect să extragă proprietățile. = {} după parametru îi dă un obiect gol când lipsește, iar valorile implicite din interior (nume = "vizitator", limba = "ro") completează proprietățile care lipsesc. Primul apel nu e afectat: valorile trimise au prioritate față de cele implicite.
Alte forme ale mesajului
TypeError: Cannot destructure property 'nume' of 'null' as it is null.TypeError: Cannot destructure property 'data' of '(intermediate value)' as it is undefined.TypeError: Cannot destructure 'undefined' as it is undefined.
Cum o eviți pe viitor
- Dă valori implicite parametrilor destructurați:
function f({ a, b } = {}). - Nu destructura direct rezultatul unor operații care pot da
undefined(find,map.get, date externe). - Pentru opțiuni de funcții, combină valorile implicite cu destructurarea:
{ limita = 10, pagina = 1 } = {}.
Întrebări frecvente
Ce înseamnă „(intermediate value)” în mesaj?
Valoarea din dreapta nu avea un nume, de exemplu rezultatul unui apel: const { data } = await incarca(). Funcția a returnat undefined, probabil fără return.
Destructurarea din tablouri dă aceeași eroare?
Nu exact: const [a] = undefined dă undefined is not iterable. Cauza e aceeași: valoarea din dreapta lipseș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: comenzi is not iterable Folosești `for...of`, spread (`...x`) sau destructurare de tablou pe o valoare care nu poate fi parcursă: un obiect simplu, un număr, `undefined` sau `null`. Pentru obiecte, parcurge `Object.entries(obj)`; pentru `undefined`, află de ce lipsesc datele. 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 ?? {})`. Î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.
