CKTIS / JavaScript
Object.defineProperties: няколко descriptors наведнъж
Object.defineProperties дефинира няколко свойства с пълни descriptors след събиране и проверка на цялата карта.
Версия: ECMAScript 5 onward; example target: Node.js 24.22.2
Синтаксис
Object.defineProperties(obj, properties)Object.defineProperties(obj, properties) изисква obj да е обект и не опакова примитиви. properties минава през ToObject, затова null и undefined хвърлят TypeError. Методът прави snapshot на собствените string и symbol ключове на картата и включва само тези, чийто текущ собствен descriptor е enumerable.
Първо прочита всяка избрана стойност и я преобразува чрез ToPropertyDescriptor; започва да дефинира свойства върху target едва след успешно събиране на всички descriptors. Невалиден descriptor или хвърлящ getter в първата фаза оставя target непроменен. Фазата на дефиниране обаче е последователна, не транзакционна: при по-късен неуспех предишните дефиниции може да останат.
Методът връща същия obj и съществува от ECMAScript 5. При създаване на ново свойство пропуснатите writable, enumerable и configurable стават false, а пропуснатите value, get и set — undefined; при промяна на съществуващо свойство пропуснатите полета остават непроменени. value/writable не могат да се смесват с get/set, а accessor трябва да е callable или undefined. Getters и Proxy traps върху картата или target могат да изпълняват код и да хвърлят.
Примери
const token = Symbol("token");
const target = {};
Object.defineProperties(target, {
visible: { value: 3, enumerable: true },
doubled: { get() { return this.visible * 2; }, enumerable: true },
[token]: { value: "ok" }
});
console.log(Object.keys(target).join(","), target.doubled, target[token]);
console.log(Object.getOwnPropertyDescriptor(target, "visible").writable);
const untouched = {};
try {
Object.defineProperties(untouched, {
first: { value: 1 },
bad: { get: 1 }
});
} catch (error) { console.log(error.name, Object.hasOwn(untouched, "first")); }
const partial = {};
Object.defineProperty(partial, "locked", { value: 1 });
try {
Object.defineProperties(partial, {
added: { value: 2 },
locked: { value: 3 }
});
} catch (error) { console.log(error.name, partial.added, partial.locked); }Резултат
visible,doubled 6 ok false TypeError false TypeError 2 1
Примерът показва symbols, ограничителни defaults, предварителна проверка и частична промяна.