Object.keys()

Object.keys() 静态方法返回给定对象自身可枚举的字符串键属性名的数组。

试一试

语法

js
Object.keys(obj)

参数

obj

一个对象。

返回值

一个字符串数组，表示给定对象自身可枚举的字符串键属性键。

描述

Object.keys() 返回一个数组，其元素是字符串，对应于直接在 object 上找到的可枚举字符串键属性名。这与使用 for...in 循环迭代相同，不同之处在于 for...in 循环还会枚举原型链中的属性。Object.keys() 返回的数组的顺序与 for...in 循环提供的顺序相同。

如果您需要属性值，请改用 Object.values()。如果您需要属性键和值，请改用 Object.entries()。

示例

使用 Object.keys()

js
// Simple 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。只有字符串可能具有自身可枚举属性，而所有其他基本类型都返回空数组。

js
// 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)); // []

注意：在 ES5 中，将非对象传递给 Object.keys() 会抛出 TypeError。

规范

规范
ECMAScript 语言规范
# sec-object.keys

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅