TypeError: Property description must be an object: 5
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
Object.defineProperty(produs, "pret", 5);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
const elev = Object.create(persoana, { nume: "Ana", varsta: 20 });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ă
Object.defineProperties(setari, { tema: "dark", limba: "ro" });Object.assign(setari, { tema: "dark", limba: "ro" });Dacă nu ai nevoie de proprietăți speciale, Object.assign sau spread-ul copiază valorile direct.
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.
const produs = { nume: "Cafea" };
Object.defineProperty(produs, "pret", 25);
console.log(`Chei: ${Object.keys(produs).join(", ")}`);
console.log(`Modificabil: ${Object.getOwnPropertyDescriptor(produs, "pret").writable}`);Chei: nume, pret Modificabil: false
Indiciu
Al treilea argument e un obiect cu value, enumerable și writable.
Reparația
const produs = { nume: "Cafea" };
Object.defineProperty(produs, "pret", {
value: 25,
enumerable: true,
writable: false,
});
console.log(`Chei: ${Object.keys(produs).join(", ")}`);
console.log(`Modificabil: ${Object.getOwnPropertyDescriptor(produs, "pret").writable}`);De ce merge
Object.defineProperty primește un descriptor, nu valoarea propriu-zisă. Numărul 25 nu e obiect, de aceea motorul a aruncat eroarea. Descriptorul { value: 25, enumerable: true, writable: false } pune valoarea, face cheia vizibilă pentru Object.keys și blochează modificarea. getOwnPropertyDescriptor confirmă că writable este false.
Alte forme ale mesajului
TypeError: Property description must be an object: undefinedTypeError: Property description must be an object: AnaTypeError: Property description must be an object: true
Cum o eviți pe viitor
- Ține minte:
defineProperty,definePropertiesșiObject.createprimesc descriptori, nu valori. - Folosește
definePropertydoar când chiar ai nevoie dewritable: false,enumerable: falsesau getter. Altfel,obj.x = valoare. - Scrie descriptorii complet (
value,enumerable,writable), ca să nu fii surprins de valorile implicitefalse. - 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
TypeError: Object.defineProperty called on non-object Primul argument dat lui Object.defineProperty nu e obiect: e un text, un număr, true, null sau undefined. Proprietăți definite așa se pot pune doar pe obiecte (inclusiv tablouri și funcții). Verifică valoarea și, dacă e primitivă, transform-o întâi în obiect. TypeError: Invalid property descriptor. Cannot both specify accessors and a value or writable attribute, #<Object> În Object.defineProperty ai pus în același descriptor și get/set, și value sau writable. O proprietate e fie cu valoare (value, writable), fie calculată (get, set), nu amândouă. Păstrează doar get (și eventual set) sau doar value. TypeError: Cannot redefine property: id Ai apelat `Object.defineProperty` pe o proprietate care e deja definită ca **non-configurable**, de obicei tot printr-un `defineProperty` anterior (unde `configurable` e implicit `false`). Pune `configurable: true` la prima definire sau nu mai redefini proprietatea. Î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.
