Object.keys()

Статический метод Object.keys() возвращает массив собственных перечисляемых строковых ключей свойств данного объекта.

Попробуйте

const object = {
  a: "some string",
  b: 42,
  c: false,
};

console.log(Object.keys(object));
// Expected output: Array ["a", "b", "c"]

Синтаксис

Object.keys(obj)

Параметры

obj

Объект.

Возвращаемое значение

Массив строк, представляющих собственные перечисляемые строковые ключи свойств данного объекта.

Описание

Object.keys() возвращает массив, элементы которого являются строками, соответствующими именам перечисляемых строковых ключей свойств, найденных непосредственно в object. Это аналогично итерации с помощью цикла for...in, за исключением того, что цикл for...in перебирает свойства в цепочке прототипов. Порядок массива, возвращаемого Object.keys(), совпадает с порядком, предоставляемым циклом for...in.

Если вам нужны значения свойств, вместо этого используйте Object.values(). Если вам нужны как ключи, так и значения свойств, вместо этого используйте Object.entries().

Примеры

Использование Object.keys()

// Basic array
const arr = ["a", "b", "c"];
console.log(Object.keys(arr)); // ['0', '1', '2']

// Array-like object
const obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.keys(obj)); // ['0', '1', '2']

// Array-like object with random key ordering
const anObj = { 100: "a", 2: "b", 7: "c" };
console.log(Object.keys(anObj)); // ['2', '7', '100']

// getFoo is a non-enumerable property
const myObj = Object.create(
  {},
  {
    getFoo: {
      value() {
        return this.foo;
      },
    },
  },
);
myObj.foo = 1;
console.log(Object.keys(myObj)); // ['foo']

Если вам нужны *все* собственные строковые свойства, включая неперечисляемые, см. Object.getOwnPropertyNames().

Использование Object.keys() на примитивах

Аргументы, не являющиеся объектами, преобразуются в объекты. undefined и null не могут быть преобразованы в объекты и немедленно вызывают TypeError. Только строки могут иметь собственные перечисляемые свойства, в то время как все остальные примитивы возвращают пустой массив.

// Strings have indices as enumerable own properties
console.log(Object.keys("foo")); // ['0', '1', '2']

// Other primitives except undefined and null have no own properties
console.log(Object.keys(100)); // []

Спецификации

Совместимость с браузерами

См. также

• Polyfill для Object.keys в core-js
• Polyfill Object.keys от es-shims
• Перечисляемость и владение свойствами
• Object.entries()
• Object.values()
• Object.prototype.propertyIsEnumerable()
• Object.create()
• Object.getOwnPropertyNames()
• Map.prototype.keys()