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

CKTIS / JavaScript

Reflect.getOwnPropertyDescriptor — проверка на собствено свойство

Reflect.getOwnPropertyDescriptor(target, key) връща дескриптора на собствено свойство или undefined. С него можете да проверите стойността, аксесорите и атрибутите на свойство, без да претърсвате веригата от прототипи.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

Reflect.getOwnPropertyDescriptor(target, key)

Reflect.getOwnPropertyDescriptor(target, key) описва само собствено свойство на target, включително ако то не е изброимо. Връща нов обект дескриптор или undefined, ако свойството не е собствено. Наследено свойство не се търси по веригата от прототипи; собствено свойство със стойност undefined все пак има дескриптор.

Дескрипторът на данни съдържа value, writable, enumerable и configurable. Дескрипторът на аксесор съдържа get и set вместо value и writable; техните стойности са функции или undefined. Проверката на дескриптора на обикновен обект не извиква неговия getter. Промяната на върнатия дескриптор сама по себе си не предефинира свойството; за това използвайте например Object.defineProperty.

target трябва да е обект; всяка примитивна стойност, включително null и undefined, причинява TypeError. Това се различава от Object.getOwnPropertyDescriptor, който обвива примитивните стойности с изключение на null и undefined. Операцията ToPropertyKey преобразува key в ключ на свойство. Ако key е обект, операцията първо го преобразува в примитивна стойност, например като извика неговия метод Symbol.toPrimitive. Ако примитивната стойност е символ, той се запазва като ключ; в противен случай стойността се преобразува в низ.

Не приемайте, че операцията винаги е без странични ефекти: преобразуването на key може да изпълни потребителски код, а Proxy може да задейства своя капан getOwnPropertyDescriptor. Получените изключения се предават на извикващия. Примерът показва, че наследено свойство се игнорира и че промяната на descriptor.value не променя item.score.

Примери

const item = Object.create({ inherited: 1 });
Object.defineProperty(item, "score", {
  value: 42,
  writable: false,
  enumerable: true,
  configurable: true
});

const descriptor = Reflect.getOwnPropertyDescriptor(item, "score");
console.log(JSON.stringify(descriptor));
console.log(Reflect.getOwnPropertyDescriptor(item, "inherited"));
descriptor.value = 99;
console.log(item.score);

Резултат

{"value":42,"writable":false,"enumerable":true,"configurable":true}
undefined
42

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници