CKTIS / JavaScript
Object.getOwnPropertyDescriptor — проверка на собствено свойство
Object.getOwnPropertyDescriptor връща описание на собствено свойство на обект: стойността му или неговите аксесори, както и флаговете на атрибутите му. Не търси по веригата от прототипи и връща undefined, ако обектът няма такова собствено свойство.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Object.getOwnPropertyDescriptor(obj, key)Object.getOwnPropertyDescriptor(obj, key) прочита дескриптора на едно собствено свойство, включително ако то не е изброимо. Не търси в прототипите. Резултатът е нов обект дескриптор или undefined, ако свойството не се намира директно в obj. Съществуващо свойство със стойност undefined все пак има дескриптор.
Дескрипторът на свойство с данни съдържа value, writable, enumerable и configurable. Дескрипторът на аксесорно свойство съдържа get и set вместо value и writable; липсващ аксесор има стойност undefined. При обикновен обект прочитането на дескриптора не извиква getter-а. writable определя дали присвояване може да промени стойността, enumerable — дали свойството се включва в изброяване, а configurable — дали може да бъде изтрито или преконфигурирано.
Промяната на полетата на върнатия обект не променя първоначалното свойство. За да приложите дескриптор, използвайте Object.defineProperty, като отчетете ограниченията на съществуващото свойство. Дескрипторът не е дълбоко копие: обект, съхранен в value, остава същата референция.
key се преобразува в ключ на свойство: низ или символ. Подаването на null или undefined като obj предизвиква TypeError; другите примитивни стойности се обвиват като обекти. При Proxy операцията може да извика капана getOwnPropertyDescriptor, затова може да има странични ефекти или да хвърли изключение.
Примери
const obj = Object.create({ inherited: 1 });
Object.defineProperty(obj, "score", {
value: 42,
writable: false,
enumerable: true,
configurable: true
});
const descriptor = Object.getOwnPropertyDescriptor(obj, "score");
console.log(descriptor.value, descriptor.writable);
console.log(descriptor.enumerable, descriptor.configurable);
descriptor.value = 99;
console.log(obj.score);
console.log(Object.getOwnPropertyDescriptor(obj, "inherited"));Резултат
42 false true true 42 undefined
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.