...
Eroare JavaScript · Valori undefined și null

TypeError: Cannot destructure property 'nume' of 'undefined' as it is undefined.

Pe scurt

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

Greșit
JavaScript
function salut({ nume }) {
  return `Salut, ${nume}`;
}
salut();
Corect
JavaScript
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

Greșit
JavaScript
const { pret } = produse.find((p) => p.cod === "X");
Corect
JavaScript
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

Greșit
JavaScript
const { oras } = client.adresa;
Corect
JavaScript
const { oras } = client.adresa ?? {};

?? {} înlocuiește lipsa adresei cu un obiect gol, iar oras devine undefined în loc de eroare.

Repară tu

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.

Codul care dă eroarea
JavaScript
function bunVenit({ nume, limba }) {
  const salut = limba === "en" ? "Welcome" : "Bun venit";
  console.log(`${salut}, ${nume}!`);
}

bunVenit({ nume: "Maria", limba: "en" });
bunVenit();
După reparație, programul afișează
Welcome, Maria!
Bun venit, vizitator!
Indiciu

Poți da o valoare implicită întregului parametru și fiecărei proprietăți.

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

← 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.