概要
Object.keys()
メソッドは、与えられたオブジェクト自身に存在する列挙可能なプロパティの配列を for...in
ループで提供されるものと同じ順番で返します (for-in ループとの違いは、for-in ループではプロトタイプチェインのプロパティも列挙することです)。
構文
Object.keys(obj)
引数
- obj
- 自身の列挙可能なプロパティが返されるオブジェクトです。
返り値
与えられたオブジェクトのすべての列挙可能なプロパティを表す文字列の配列。
説明
Object.keys()
は、object
で直接発見された列挙可能なプロパティに対応する文字列を要素とする配列を返します。プロパティの順序は、オブジェクトのプロパティをループにより手動で取得した場合と同じです。
例
var arr = ['a', 'b', 'c']; console.log(Object.keys(arr)); // console: ['0', '1', '2'] // array like object var obj = { 0: 'a', 1: 'b', 2: 'c' }; console.log(Object.keys(obj)); // console: ['0', '1', '2'] // array like object with random key ordering var an_obj = { 100: 'a', 2: 'b', 7: 'c' }; console.log(Object.keys(an_obj)); // console: ['2', '7', '100'] // getFoo is property which isn't enumerable var my_obj = Object.create({}, { getFoo: { value: function() { return this.foo; } } }); my_obj.foo = 1; console.log(Object.keys(my_obj)); // console: ['foo']
列挙可能ではないものを含むすべてのプロパティを取得したい場合、Object.getOwnPropertyNames()
をご覧ください。
注記
ES5 では、このメソッドの引数がオブジェクトでない場合 (プリミティブ値)、TypeError
が発生します。ES6 では、オブジェクトでない引数はオブジェクトに強制的に変換されます。
Object.keys("foo");
// TypeError: "foo" is not an object (ES5 code)
Object.keys("foo");
// ["0", "1", "2"] (ES6 code)
Polyfill
Object.keys
をネイティブにサポートしていない環境向けに互換性を確保するため、以下のコード部品をコピーしましょう:
// From https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/keys if (!Object.keys) { Object.keys = (function() { 'use strict'; var hasOwnProperty = Object.prototype.hasOwnProperty, hasDontEnumBug = !({ toString: null }).propertyIsEnumerable('toString'), dontEnums = [ 'toString', 'toLocaleString', 'valueOf', 'hasOwnProperty', 'isPrototypeOf', 'propertyIsEnumerable', 'constructor' ], dontEnumsLength = dontEnums.length; return function(obj) { if (typeof obj !== 'object' && (typeof obj !== 'function' || obj === null)) { throw new TypeError('Object.keys called on non-object'); } var result = [], prop, i; for (prop in obj) { if (hasOwnProperty.call(obj, prop)) { result.push(prop); } } if (hasDontEnumBug) { for (i = 0; i < dontEnumsLength; i++) { if (hasOwnProperty.call(obj, dontEnums[i])) { result.push(dontEnums[i]); } } } return result; }; }()); }
上記のコードは IE7 において (もしかすると IE8 でも)、他のウィンドウから渡されたオブジェクトの場合、列挙不可能な key を含むことに注意してください。
より簡単なブラウザー Polyfill については、Javascript - Object.keys Browser Compatibility をご覧ください。
仕様書
仕様 | ステータス | コメント |
---|---|---|
ECMAScript 5.1 (ECMA-262) Object.keys の定義 |
標準 | 初回定義。JavaScript 1.8.5 で実装。 |
ECMAScript 2015 (6th Edition, ECMA-262) Object.keys の定義 |
標準 | |
ECMAScript 2017 Draft (ECMA-262) Object.keys の定義 |
ドラフト |
ブラウザー互換性
機能 | Firefox (Gecko) | Chrome | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
基本サポート | 5 | 4.0 (2.0) | 9 | 12 | 5 |
機能 | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
基本サポート | ? | ? | ? | ? | ? | ? |