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

CKTIS / JavaScript

Object.getOwnPropertyNames — имена на собствени свойства

Object.getOwnPropertyNames(obj) връща нов масив със стрингови ключове. При обикновени обекти той съдържа стринговите ключове на всички собствени свойства, включително неизброимите. Ключовете от тип Symbol се пропускат, а при Proxy списъкът може да зависи от капана ownKeys.

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

Синтаксис

Object.getOwnPropertyNames(obj)

Object.getOwnPropertyNames(obj) е статичен метод: извикайте го върху Object, а не върху проверявания обект. Връща нов масив само със стринговите ключове от резултата на вътрешната операция [[OwnPropertyKeys]], без да проверява дескрипторите на свойствата. При обикновените обекти това са всички собствени стрингови ключове, независимо от атрибута enumerable, но не и ключовете на наследени свойства. Методът връща ключове, а не стойности на свойства.

При обикновените обекти Object.keys(obj) включва само изброимите собствени свойства със стрингови ключове. Object.getOwnPropertySymbols(obj) връща собствените ключове от тип Symbol, а Reflect.ownKeys(obj) връща както собствените стрингови ключове, така и собствените ключове от тип Symbol, включително ключовете на неизброимите свойства. „Собствено“ и „изброимо“ означават различни характеристики.

При обикновените обекти имената, които са индекси на масив, се появяват първи във възходящ числов ред; останалите стрингови ключове следват реда на създаване на свойствата. Това не е азбучно сортиране. Обектите Proxy могат да променят списъка и реда чрез капана ownKeys, при спазване на ограниченията на спецификацията. Ако целевият обект е разширяем, капанът може да посочи стрингов ключ без съответстващ дескриптор на собствено свойство или да пропусне стринговия ключ на конфигурируемо собствено свойство на целевия обект.

null и undefined причиняват TypeError; другите примитивни стойности се преобразуват в обекти. Примерът показва подреждането на индексите и включването на hidden, което по подразбиране е неизброимо при тази употреба на Object.defineProperty. Свойството inherited и ключът Symbol се пропускат.

Примери

const obj = Object.create({ inherited: true });
obj[10] = 'ten';
obj[2] = 'two';
obj.label = 'demo';
Object.defineProperty(obj, 'hidden', { value: 42 });
obj[Symbol('token')] = 'secret';

console.log(JSON.stringify(Object.getOwnPropertyNames(obj)));
console.log(JSON.stringify(Object.keys(obj)));

Резултат

["2","10","label","hidden"]
["2","10","label"]

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

Източници