Object.entries()
Object.entries() 靜態方法返回給定物件自身可列舉字串鍵屬性的鍵值對陣列。
試一試
const object = {
a: "some string",
b: 42,
};
for (const [key, value] of Object.entries(object)) {
console.log(`${key}: ${value}`);
}
// Expected output:
// "a: some string"
// "b: 42"
語法
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)); // []
將 Object 轉換為 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}
迭代 Object
使用 陣列解構，您可以輕鬆地迭代物件。
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® 2026 語言規範 # sec-object.entries |
瀏覽器相容性
載入中…