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

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, предварителна проверка и частична промяна.

Източници