Object.keys()
Object.keys() 静态方法会返回一个由给定对象自身可枚举的字符串键属性组成的数组。
试一试
const object = {
a: "some string",
b: 42,
c: false,
};
console.log(Object.keys(object));
// Expected output: Array ["a", "b", "c"]
语法
js
Object.keys(obj)
参数
obj-
一个对象。
返回值
一个字符串数组，表示给定对象自身可枚举的字符串键属性。
描述
Object.keys() 返回一个数组，其元素是直接在 object 上找到的可枚举的字符串键属性名称。这与使用 for...in 循环进行迭代相同，不同之处在于 for...in 循环还会枚举原型链上的属性。Object.keys() 返回的数组的顺序与 for...in 循环提供的顺序相同。
如果你需要属性值，请改用 Object.values()。如果你同时需要属性键和值，请改用 Object.entries()。
示例
使用 Object.keys()
js
// 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。只有字符串可以拥有自身的枚举属性，而所有其他原始值都会返回一个空数组。
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® 2026 语言规范 # sec-object.keys |
浏览器兼容性
加载中…