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

CKTIS / JavaScript

Object.keys — собствени изброими ключове на обект

Object.keys(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.keys(obj)

Object.keys(obj) е статичен метод на Object, който връща нов масив с имената на свойствата. Той включва само собствени свойства, тоест такива, които не са наследени от прототип, чийто атрибут enumerable е true и чийто ключ е низ. Резултатът съдържа низове дори когато ключовете са записани като числа. Ключовете Symbol се изключват.

При обикновените обекти ключовете, които са индекси на масив, се подреждат във възходящ числов ред, следвани от останалите низови ключове в реда на създаване на свойствата. Това не е азбучно сортиране и не важи за всеки низ, който прилича на число: "02" не е индекс на масив. Обектите Proxy могат да влияят на реда и да изпълняват код по време на изброяването.

За разлика от for...in, методът изключва наследените изброими свойства. Reflect.ownKeys(obj) включва и собствените неизброими свойства и ключовете Symbol. Самият Object.keys не чете стойностите на свойствата и не извиква техните гетъри; върнатият масив не се актуализира при промяна на обекта.

null и undefined причиняват TypeError. Останалите примитивни стойности се преобразуват в обекти: Object.keys("ab") дава ["0","1"], докато Object.keys(42) дава []. Това е API на езика ECMAScript, а не API на браузър; изпълнението на примера в Node.js не доказва съвместимост с конкретен браузър.

Примери

const item = Object.create({ inherited: true });
item.name = "Ada";
item[10] = "ten";
item[2] = "two";
Object.defineProperty(item, "hidden", { value: true });
item[Symbol("tag")] = true;

console.log(JSON.stringify(Object.keys(item)));

Резултат

["2","10","name"]

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

Източници