CKTIS / JavaScript
Reflect.defineProperty — дефиниране на свойства с булев резултат
Reflect.defineProperty дефинира или променя собствено свойство на обект чрез дескриптор. Връща true или false, но не гарантира изпълнение без изключения.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Reflect.defineProperty(target, propertyKey, attributes)Reflect.defineProperty(target, propertyKey, attributes) дефинира или променя собствено свойство на target. Ключът се преобразува в низ или символ, а attributes е обект дескриптор. Методът връща true, ако операцията е успешна, или false, ако правилата на обекта я отхвърлят.
Дескрипторът на данни използва value и writable, а дескрипторът на аксесор използва get и set. И двата могат да съдържат enumerable и configurable. Полетата за данни не трябва да се комбинират с полетата за аксесор. При създаване на свойство в обикновен обект пропуснатите флагове по подразбиране са false, а пропуснатата стойност на данните по подразбиране е undefined. При обикновен обект пропуснатите полета остават непроменени, ако при промяната на съществуващо свойство видът му се запазва. Конфигурируемо свойство може да се преобразува от свойство за данни в аксесорно свойство или обратно. Ако при преобразуването enumerable и configurable са пропуснати, те запазват досегашните си стойности. Например при преобразуване на конфигурируемо свойство за данни в аксесорно свойство чрез задаване само на get полетата value и writable отпадат, а пропуснатото поле set получава стойност undefined.
Капанът defineProperty на Proxy получава обект дескриптор, в който пропуснатите полета все още липсват. Той може да създаде свойство с различни атрибути в целевия обект на Proxy, стига да спазва инвариантите на Proxy.
За разлика от Object.defineProperty, който връща обекта и хвърля TypeError, когато дефиницията бъде отхвърлена, този метод връща булев резултат. Той обаче не е без изключения: извикването може да бъде прекъснато от target, който не е обект, невалиден дескриптор или изключение при преобразуването на ключа. Капанът defineProperty на Proxy също може да хвърли изключение.
При обикновен обект добавянето на свойство към неразширяем обект или забранената промяна на неконфигурируемо свойство връща false. В примера втората дефиниция не може да промени id, защото writable и configurable са false; стойността остава 7.
Примери
const item = {};
console.log(Reflect.defineProperty(item, "id", {
value: 7,
enumerable: true,
writable: false,
configurable: false
}));
console.log(Reflect.defineProperty(item, "id", { value: 8 }));
console.log(item.id);
console.log(Object.keys(item).join(","));Резултат
true false 7 id
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.