CKTIS / JavaScript
Object.getOwnPropertySymbols — собствени символни ключове
Object.getOwnPropertySymbols(obj) връща масив от ключове от тип Symbol. При обикновени обекти това са ключовете на собствените свойства, включително на неизброимите. Методът пропуска низовите ключове и не обхожда веригата от прототипи.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Object.getOwnPropertySymbols(obj)Object.getOwnPropertySymbols(obj) е статичен метод на Object, който създава нов масив само с ключовете от тип Symbol от списъка, върнат от вътрешната операция [[OwnPropertyKeys]] на обекта. Връща ключове, а не стойности или описания на символи. Стойността на свойство се прочита с obj[key].
Методът пропуска низовите ключове и не обхожда веригата от прототипи. Той не проверява дескрипторите на свойствата: Proxy с разширяем целеви обект може чрез прихващащия метод ownKeys да посочи символ дори ако самият прокси няма дескриптор на собствено свойство за този символ.
При обикновени обекти резултатът включва ключовете както на изброимите, така и на неизброимите собствени свойства. Символите се появяват в реда, в който са създадени тези свойства. Object.keys(obj) връща само низовите ключове на изброимите собствени свойства, Object.getOwnPropertyNames(obj) връща всички собствени низови ключове, а Reflect.ownKeys(obj) връща и двата вида собствени ключове.
Аргументът се преобразува в обект; null и undefined предизвикват TypeError. Символите не осигуряват поверителност: този метод може да открие такива ключове дори когато е зададено enumerable: false.
В примера резултатът съдържа visible и hidden, но нито inherited, нито name. Сравненията проверяват идентичността на символите, а последният ред прочита стойностите на съответните свойства.
Примери
const inherited = Symbol('inherited');
const visible = Symbol('visible');
const hidden = Symbol('hidden');
const obj = Object.create({ [inherited]: 10 });
obj.name = 'demo';
obj[visible] = 20;
Object.defineProperty(obj, hidden, {
value: 30,
enumerable: false
});
const keys = Object.getOwnPropertySymbols(obj);
console.log(keys.length);
console.log(keys[0] === visible, keys[1] === hidden);
console.log(keys.includes(inherited));
console.log(keys.map(key => obj[key]).join(','));Резултат
2 true true false 20,30
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.