База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Object.defineProperty: точен descriptor на свойство

Object.defineProperty дефинира или променя едно собствено свойство чрез явен data или accessor descriptor.

Версия: ECMAScript 5 onward; example target: Node.js 24.22.2

Синтаксис

Object.defineProperty(obj, key, descriptor)

Object.defineProperty(obj, key, descriptor) изисква реален обект като obj; примитивите не се опаковат. key минава през ToPropertyKey и става string или symbol. descriptor се прочита чрез ToPropertyDescriptor, а методът връща същия target обект.

Data descriptor използва value и writable, а accessor descriptor — get и set; смесването на полета от двата вида хвърля TypeError. При създаване на ново свойство липсващите writable, enumerable и configurable стават false, а липсващите value, get и set означават undefined; при промяна на съществуващо свойство пропуснатите полета оставят текущите му атрибути непроменени. Getter и setter трябва да са callable или undefined.

Методът съществува от ECMAScript 5. DefinePropertyOrThrow хвърля TypeError при добавяне на ново свойство към non-extensible обект, когато промяната нарушава правилата на non-configurable свойство или Proxy нарушава invariants. Съвместимо предефиниране на съществуващо свойство може да успее и върху non-extensible обект. За разлика от присвояване, методът управлява атрибутите без inherited setter, макар че descriptor полета и Proxy traps могат да изпълняват код и да хвърлят.

Примери

const account = {};
const same = Object.defineProperty(account, "balance", {
  value: 10, writable: false, enumerable: true, configurable: false
});
let reads = 0;
Object.defineProperty(account, "label", {
  get() { return `#${++reads}`; }, configurable: true
});
console.log(same === account, Object.keys(account).join(","));
console.log(account.balance, account.label, account.label);
const balance = Object.getOwnPropertyDescriptor(account, "balance");
const label = Object.getOwnPropertyDescriptor(account, "label");
console.log(balance.writable, balance.configurable, label.set);
try { Object.defineProperty(account, "balance", { value: 11 }); }
catch (error) { console.log(error.name, account.balance); }
try { Object.defineProperty({}, "x", { value: 1, get() {} }); }
catch (error) { console.log(error.name); }

Резултат

true balance
10 #1 #2
false false undefined
TypeError 10
TypeError

Примерът дефинира data свойство и getter, проверява атрибути и показва два случая TypeError.

Източници