Object.entries()

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

试一试

语法

js
Object.entries(obj)

参数

obj

一个对象。

返回值

给定对象自身可枚举的字符串键属性的键值对数组。每个键值对都是一个包含两个元素的数组：第一个元素是属性键（始终为字符串），第二个元素是属性值。

描述

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

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

示例

使用 Object.entries()

js
const obj = { foo: "bar", baz: 42 };
console.log(Object.entries(obj)); // [ ['foo', 'bar'], ['baz', 42] ]

const arrayLike = { 0: "a", 1: "b", 2: "c" };
console.log(Object.entries(arrayLike)); // [ ['0', 'a'], ['1', 'b'], ['2', 'c'] ]

const randomKeyOrder = { 100: "a", 2: "b", 7: "c" };
console.log(Object.entries(randomKeyOrder)); // [ ['2', 'b'], ['7', 'c'], ['100', 'a'] ]

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

对基本类型使用 Object.entries()

非对象参数会被 强制转换为对象。 undefined 和 null 不能强制转换为对象，并会立即抛出一个 TypeError。只有字符串可能具有自身可枚举属性，而所有其他基本类型都返回一个空数组。

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

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

将对象转换为 Map

Map() 构造函数接受一个 entries 的可迭代对象。使用 Object.entries，您可以轻松地从 Object 转换为 Map

js
const obj = { foo: "bar", baz: 42 };
const map = new Map(Object.entries(obj));
console.log(map); // Map(2) {"foo" => "bar", "baz" => 42}

遍历对象

使用 数组解构，您可以轻松地遍历对象。

js
// Using for...of loop
const obj = { a: 5, b: 7, c: 9 };
for (const [key, value] of Object.entries(obj)) {
  console.log(`${key} ${value}`); // "a 5", "b 7", "c 9"
}

// Using array methods
Object.entries(obj).forEach(([key, value]) => {
  console.log(`${key} ${value}`); // "a 5", "b 7", "c 9"
});

规范

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

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅