この記事は技術レビューを必要としています。ぜひご協力ください。
この記事は編集レビューを必要としています。ぜひご協力ください。
This is an experimental technology, part of the ECMAScript 2016 (ES7) proposal.
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future version of browsers as the spec changes.
Object.entries() メソッドは、引数に与えたオブジェクトが所有する、列挙可能なプロパティの組 [key, value] からなる配列を返します。配列要素の順序は for...in ループによる順序と同じです(両者の違いとして、for-in ループではその上プロトタイプチェーン内のプロパティも列挙されます)。
構文
Object.entries(obj)
引数
obj- 返されることになる列挙可能な所有プロパティの組
[key, value]を持つオブジェクト。
説明
Object.entries() は、object に直接存在する列挙可能プロパティの組 [key, value] が配列要素に対応した配列を返します。プロパティの順序はマニュアル操作でオブジェクト内のプロパティに対してループさせた時の順序と同じになります。
使用例
var obj = { foo: "bar", baz: 42 };
console.log(Object.entries(obj)); // [ ['foo', 'bar'], ['baz', 42] ]
// 配列様オブジェクト
var obj = { 0: 'a', 1: 'b', 2: 'c' };
console.log(Object.entries(obj)); // [ ['0', 'a'], ['1', 'b'], ['2', 'c'] ]
// ランダムなキー順序を持つ配列様オブジェクト
var an_obj = { 100: 'a', 2: 'b', 7: 'c' };
console.log(Object.entries(an_obj)); // [ ['2', 'b'], ['7', 'c'], ['100', 'a'] ]
// 列挙可能でないプロパティ getFoo がある
var my_obj = Object.create({}, { getFoo: { value: function() { return this.foo; } } });
my_obj.foo = "bar";
console.log(Object.entries(my_obj)); // [ ['foo', 'bar'] ]
// オブジェクトでない引数はオブジェクトへと型強制されます
console.log(Object.entries("foo")); // [ ['0', 'f'], ['1', 'o'], ['2', 'o'] ]
Object から Map への変換
new Map() コンストラクタは entries による反復処理に対応しています。 Object.entries を使うと、Object から Map へと簡単に変換できます。:
var obj = { foo: "bar", baz: 42 };
var map = new Map(Object.entries(obj));
console.log(map); // Map { foo: "bar", baz: 42 }
ポリフィル (Polyfill)
Object.entries をサポートしていない旧環境に互換性を持たせる場合は、tc39/proposal-object-values-entries や es-shims/Object.entries 内にポリフィルがあります。
仕様
| 仕様 | 策定状況 | コメント |
|---|---|---|
| ECMAScript 2016 Draft (7th Edition, ECMA-262) The definition of 'Object.entries' in that specification. |
ドラフト | 公式ドラフトにはまだ加えられていません。現在の仕様ドラフト文書は該当の stage3 提案書をご覧ください。 |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 未サポート | Nightly build | 未サポート | 未サポート | 未サポート [1] |
| 機能 | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| 基本サポート | 未サポート | 未サポート | Nightly build | 未サポート | 未サポート | 未サポート |
[1] bug 150131 を参考。