大网数据广告活动
Web 标准与前端开发

Object.keys()

· 52CE 我爱测

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

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

JavaScript Demo: Object.keys()

const object1 = {
  a: "somestring",
  b: 42,
  c: false,
};

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

语法

Object.keys(obj)

参数

  • obj
    • : 一个对象。

返回值

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

描述

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

如果你需要属性的值,请使用 Object.values()。如果你同时需要属性的键和值,请使用 Object.entries()。

示例

使用 Object.keys()

// 简单数组
const arr = ["a", "b", "c"];
console.log(Object.keys(arr)); // ['0', '1', '2']

// 类数组对象
const obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.keys(obj)); // ['0', '1', '2']

// 键的顺序随机的类数组对象
const anObj = { 100: "a", 2: "b", 7: "c" };
console.log(Object.keys(anObj)); // ['2', '7', '100']

// getFoo 是一个不可枚举的属性
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。只有字符串可以有自己的可枚举属性,而其他所有基本类型都返回一个空数组。

// 字符串具有索引作为可枚举的自有属性
console.log(Object.keys("foo")); // ['0', '1', '2']

// 其他基本类型(除了 undefined 和 null)没有自有属性
console.log(Object.keys(100)); // []

[!NOTE] 在 ES5 中,将一个非对象传递给 Object.keys() 会抛出一个 TypeError。

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。