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