→
引数に与えたオブジェクトが所有する、文字列をキーとした列挙可能なプロパティの組 [key, value] からなる配列を返します。
配列要素の順序は for...in ループによる順序と同じです(両者の主な違いは、for...in ループではプロトタイプチェーン内のプロパティも列挙されることです)。
Object.entries() で返される配列の順序は、オブジェクトがどのように定義されたかに依存しません。特定の順序にする必要があるのであれば、Object.entries(obj).sort((a, b) => a[0] - b[0]); のようにして、まず配列を整列する必要があります。
obj | 返されることになる文字列をキーとした列挙可能な所有プロパティの組 [key, value] を持つオブジェクト。 |
---|
引数に与えたオブジェクトが所有する、文字列をキーとした列挙可能なプロパティの組 [key, value] の配列。
Object.entries() は、object に直接存在する文字列をキーとした列挙可能プロパティの組 [key, value] が配列要素に対応した配列を返します。プロパティの順序はオブジェクト内のプロパティに対してループさせた時の順序と同じになります。
const obj = { foo: 'bar', baz: 42 }; D=Object.entries(obj); //=[ ['foo', 'bar'], ['baz', 42] ]
// 配列様オブジェクト const obj = { 0: 'a', 1: 'b', 2: 'c' }; D=Object.entries(obj); //=[ ['0', 'a'], ['1', 'b'], ['2', 'c'] ]
// ランダムなキー順序を持つ配列様オブジェクト const anObj = { 100: 'a', 2: 'b', 7: 'c' }; D=Object.entries(anObj); //=[ ['2', 'b'], ['7', 'c'], ['100', 'a'] ]
// 列挙可能でないプロパティ getFoo がある const myObj = Object.create({}, { getFoo: { value() { return this.foo; } } }); myObj.foo = 'bar'; D=Object.entries(myObj); //=[ ['foo', 'bar'] ]
// オブジェクトでない引数はオブジェクトへと型強制されます D=Object.entries('foo'); //=[ ['0', 'f'], ['1', 'o'], ['2', 'o'] ]
// プリミティブには独自のプロパティがないため、プリミティブ型に対して空の配列を返します D=Object.entries(100); //=[ ]
// Key‐Valueを適切に反復します const obj = { a: 5, b: 7, c: 9 }; for (const [key, value] of Object.entries(obj)) { alert(`${key} ${value}`); // "a 5"、"b 7"、"c 9" } // Or, using array extras Object.entries(obj).forEach(([key, value]) => { alert(`${key} ${value}`); // "a 5"、"b 7"、"c 9" });
new Map() コンストラクターは entries による反復処理に対応しています。Object.entries を使うと、Object から Map へと簡単に変換できます。:
const obj = { foo: 'bar', baz: 42 }; const map = new Map(Object.entries(obj)); D=map; //={ foo: "bar", baz: 42 }
Array Destructuring を使って、objects を簡単にループできます。
const obj = { foo: 'bar', baz: 42 }; Object.entries(obj).forEach( ([key, value]) => alert(`${key}: ${value}`) ); // "foo: bar"、"baz: 42"