CKTIS / JavaScript
Reflect.ownKeys — всички собствени ключове на обект
Reflect.ownKeys(target) изисква аргументът да е обект. За обикновен обект връща масив с всички собствени ключове: низове и символи, включително ключовете на неенумерируеми свойства. Пропуска наследените свойства. Капанът ownKeys на Proxy може да промени кои ключове се връщат.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
Reflect.ownKeys(target)Reflect.ownKeys(target) създава нов масив с ключове. Ако target е обикновен обект, масивът съдържа ключовете на всички негови собствени свойства, както енумерируеми, така и неенумерируеми. Елементите са низове или символи, а не стойностите на свойствата. Методът не претърсва веригата от прототипи. Аргумент, който не е обект, включително null или низ, причинява TypeError; той не се преобразува автоматично в обект.
При обикновените обекти първо идват ключовете, които са индекси на масив, във възходящ числов ред. Следват останалите низове в реда на създаване на свойствата, а накрая — символите в реда на създаване на съответните свойства. Затова "2" е преди "10", дори да са добавени в обратен ред; самите ключове продължават да са низове.
За разлика от това Object.keys връща само енумерируеми ключове от тип низ. Object.getOwnPropertyNames включва собствените ключове от тип низ, а Object.getOwnPropertySymbols — собствените символи. Използвай Reflect.ownKeys, когато са ти нужни и двата вида ключове без филтриране според енумерируемостта.
Методът извиква вътрешната операция [[OwnPropertyKeys]]. При Proxy това може да задейства капана ownKeys, така че да се изпълни потребителски код, да възникне изключение или ключовете да се върнат в различен допустим ред от този при обикновен обект. Капанът може да промени и множеството от върнатите ключове: ако целевият обект на проксито е разширяем, капанът може да пропусне ключове на конфигурируеми собствени свойства или да върне допълнителни ключове, за които целевият обект няма дескриптор на собствено свойство. Той трябва да включи ключовете на неконфигурируемите собствени свойства. Ако целевият обект не е разширяем, върнатото множество трябва да съвпада точно с множеството на собствените му ключове. Не приемай, че всеки екзотичен обект използва обичайния ред. Това е API на езика ECMAScript; самото наличие на Node 24 в хранилище не доказва поддръжка в целевия браузър.
Примери
const tag = Symbol("tag");
const target = Object.create({ inherited: true });
target["10"] = "ten";
target["2"] = "two";
target.name = "Ada";
Object.defineProperty(target, "hidden", { value: 42 });
target[tag] = "metadata";
const keys = Reflect.ownKeys(target);
console.log(keys.map(key => String(key)).join(" | "));
console.log(keys[keys.length - 1] === tag);Резултат
2 | 10 | name | hidden | Symbol(tag) true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.