このページはコミュニティーの尽力で英語から翻訳されました。MDN Web Docsコミュニティーについてもっと知り、仲間になるにはこちらから。
Object.entries()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2017年3月.
Object.entries() は静的メソッドで、与えられたオブジェクトが所有する、文字列をキーとした列挙可能なプロパティのキーと値の組の配列を返します。
試してみましょう
const object = { a: "some string", b: 42,};for (const [key, value] of Object.entries(object)) { console.log(`${key}: ${value}`);}// 予想される結果:// "a: some string"// "b: 42"構文
Object.entries(obj)引数
objオブジェクト。
返値
指定されたオブジェクト自身が持つ、文字列キーで列挙可能なプロパティのキーと値の組の配列。キーと値の組はそれぞれ 2 つの要素を持つ配列で、最初の要素がプロパティキー（常に文字列）、 2 つ目がプロパティ値です。
解説
Object.entries() は、object に直接得られる文字列キーで列挙可能なプロパティのキーと値の組に対応する配列の要素を返します。これはfor...in ループで反復処理するのと同じですが、for...in ループではプロトタイプチェーンのプロパティも列挙されます。Object.entries() が返す配列の順序は、for...in ループで指定されたものと同じです。
プロパティのキーだけが必要な場合は、代わりにObject.keys() を使用します。プロパティの値だけが必要な場合は、代わりにObject.values() を使用します。
例
Object.entries() の使用
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 があるconst myObj = Object.create( {}, { getFoo: { value() { return this.foo; }, }, },);myObj.foo = "bar";console.log(Object.entries(myObj)); // [ ['foo', 'bar'] ]プリミティブに対する Object.entries() の使用
オブジェクト以外の引数はオブジェクトに変換されます。undefined とnull はオブジェクトに変換することができず、事前にTypeError が発生します。文字列のみが自分自身で列挙可能なプロパティを持つことができ、他のすべてのプリミティブは空の配列を返します。
// オブジェクトでない引数はオブジェクトへと型変換されるconsole.log(Object.entries("foo")); // [ ['0', 'f'], ['1', 'o'], ['2', 'o'] ]// undefined と null 以外の他のプリミティブには独自のプロパティがないconsole.log(Object.entries(100)); // []Object から Map への変換
Map() コンストラクターはentries による反復処理に対応しています。Object.entries を使うと、Object からMap へと簡単に変換できます。
const obj = { foo: "bar", baz: 42 };const map = new Map(Object.entries(obj));console.log(map); // Map(2) {"foo" => "bar", "baz" => 42}Object の反復処理
配列の構造分解を使って、オブジェクトを簡単に反復処理することができます。
// for...of ループの使用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"}// 配列のメソッドの使用Object.entries(obj).forEach(([key, value]) => { console.log(`${key} ${value}`); // "a 5", "b 7", "c 9"});仕様書
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-object.entries |