...
Eroare JavaScript · Obiecte și clase

TypeError: Property description must be an object: 5

Pe scurt

Al treilea argument al lui Object.defineProperty (sau valorile din Object.defineProperties / Object.create) trebuie să fie un descriptor, adică un obiect ca { value: 5 }, nu valoarea direct. Înfășoară valoarea: { value: 5, enumerable: true, writable: true }.

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

Ce înseamnă

Object.defineProperty(obj, "pret", descriptor) nu primește valoarea proprietății, ci un descriptor: un obiect care descrie proprietatea, cu câmpuri ca value, writable, enumerable, configurable sau get/set. Dacă trimiți direct valoarea (5, "Ana", true), motorul aruncă Property description must be an object: 5, iar la final îți arată chiar valoarea primită.

Aceeași regulă se aplică la Object.defineProperties(obj, { pret: descriptor }) și la al doilea argument al lui Object.create(proto, { nume: descriptor }): fiecare cheie trebuie să aibă ca valoare un descriptor, nu valoarea simplă. E o confuzie frecventă, pentru că semnătura seamănă cu Object.assign, care primește valori directe.

Valoarea din mesaj te ajută să găsești locul: caută în cod unde trimiți acea valoare ca al treilea argument sau ca valoare într-un obiect de descriptori.

De ce apare: cauzele frecvente

1Valoarea dată direct lui defineProperty

Greșit
JavaScript
Object.defineProperty(produs, "pret", 5);
Corect
JavaScript
Object.defineProperty(produs, "pret", {
  value: 5,
  writable: true,
  enumerable: true,
});

Descriptorul spune ce valoare are proprietatea și cum se comportă. Fără enumerable: true, ea nu apare în Object.keys.

2Object.create cu valori în loc de descriptori

Greșit
JavaScript
const elev = Object.create(persoana, { nume: "Ana", varsta: 20 });
Corect
JavaScript
const elev = Object.create(persoana, {
  nume: { value: "Ana", enumerable: true },
  varsta: { value: 20, enumerable: true },
});

Al doilea argument al lui Object.create e un obiect de descriptori, la fel ca la defineProperties.

3Ai vrut de fapt o copiere simplă

Greșit
JavaScript
Object.defineProperties(setari, { tema: "dark", limba: "ro" });
Corect
JavaScript
Object.assign(setari, { tema: "dark", limba: "ro" });

Dacă nu ai nevoie de proprietăți speciale, Object.assign sau spread-ul copiază valorile direct.

Repară tu

Repară eroarea, direct în pagină

Codul vrea să adauge produsului un pret care nu poate fi modificat, dar dă valoarea direct lui Object.defineProperty și primește TypeError: Property description must be an object: 25. Repară apelul cu un descriptor care face proprietatea vizibilă în Object.keys, dar nemodificabilă, ca programul să afișeze cele două rânduri.

Codul care dă eroarea
JavaScript
const produs = { nume: "Cafea" };

Object.defineProperty(produs, "pret", 25);

console.log(`Chei: ${Object.keys(produs).join(", ")}`);
console.log(`Modificabil: ${Object.getOwnPropertyDescriptor(produs, "pret").writable}`);
După reparație, programul afișează
Chei: nume, pret
Modificabil: false
Indiciu

Al treilea argument e un obiect cu value, enumerable și writable.

Alte forme ale mesajului

  • TypeError: Property description must be an object: undefined
  • TypeError: Property description must be an object: Ana
  • TypeError: Property description must be an object: true

Cum o eviți pe viitor

  • Ține minte: defineProperty, defineProperties și Object.create primesc descriptori, nu valori.
  • Folosește defineProperty doar când chiar ai nevoie de writable: false, enumerable: false sau getter. Altfel, obj.x = valoare.
  • Scrie descriptorii complet (value, enumerable, writable), ca să nu fii surprins de valorile implicite false.
  • Verifică rezultatul cu Object.getOwnPropertyDescriptor(obj, "x").

Întrebări frecvente

Ce valori implicite are un descriptor?

Câmpurile lipsă sunt false: writable, enumerable și configurable. De aceea o proprietate creată cu { value: 5 } nu apare în Object.keys și nu poate fi modificată.

De ce mesajul conține valoarea mea la final?

Ca să o recunoști ușor: e exact ce ai trimis în locul descriptorului. „Property description must be an object: Ana” înseamnă că textul „Ana” a ajuns unde trebuia un obiect.

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.