Object.getOwnPropertyNames()

Object.getOwnPropertyNames() 静的メソッドは、与えられたオブジェクトで発見されたすべての直接のプロパティを含む配列を(シンボルを使用したものを除き、列挙不可能なプロパティを含んで)返します。

試してみましょう

構文

js
Object.getOwnPropertyNames(obj)

引数

obj

オブジェクトで、これ自身の列挙可能および列挙不可能なプロパティが返されます。

返値

指定されたオブジェクトで発見された、列挙可能および列挙不可能なプロパティに対応する文字列を要素とする配列。

解説

Object.getOwnPropertyNames() は、 obj で発見された列挙可能および列挙不可能なプロパティに対応する文字列を要素とする配列を返します。配列内における列挙可能なプロパティの順序は、オブジェクトで for...in (または Object.keys()) を実行して見つかるものの順序と同じです。 ES6 によれば、オブジェクトの整数のキーは (列挙可能であっても列挙不可能であっても) 最初の配列に昇順で追加され、その後に挿入順を表す文字列キーが続きます。

ES5 では、このメソッドの引数がオブジェクトではない (プリミティブである) 場合、 TypeError が発生します。 ES2015 では、引数がオブジェクトではない場合はオブジェクトに型変換されます。

js
Object.getOwnPropertyNames("foo");
// TypeError: "foo" is not an object (ES5 code)

Object.getOwnPropertyNames("foo");
// ["0", "1", "2", "length"]  (ES2015 code)

Object.getOwnPropertyNames() の使用

js
const arr = ["a", "b", "c"];
console.log(Object.getOwnPropertyNames(arr).sort());
// ["0", "1", "2", "length"]

// 配列風オブジェクト
const obj = { 0: "a", 1: "b", 2: "c" };
console.log(Object.getOwnPropertyNames(obj).sort());
// ["0", "1", "2"]

Object.getOwnPropertyNames(obj).forEach((val, idx, array) => {
  console.log(`${val} -> ${obj[val]}`);
});
// 0 -> a
// 1 -> b
// 2 -> c

// 列挙不可能なプロパティ
const myObj = Object.create(
  {},
  {
    getFoo: {
      value() {
        return this.foo;
      },
      enumerable: false,
    },
  },
);
myObj.foo = 1;

console.log(Object.getOwnPropertyNames(myObj).sort()); // ["foo", "getFoo"]

列挙可能なプロパティのみ取得したい場合は Object.keys() を参照するか、 for...in ループを用いるかしてください(なお、この場合は Object.hasOwn() でフィルタリングされない限り、プロトタイプチェーン上の列挙可能なプロパティも返されることに注意してください)。

プロトタイプチェーン上のプロパティは配列に含まれません。

js
function ParentClass() {}
ParentClass.prototype.inheritedMethod = function () {};

function ChildClass() {
  this.prop = 5;
  this.method = function () {};
}
ChildClass.prototype = new ParentClass();
ChildClass.prototype.prototypeMethod = function () {};

console.log(Object.getOwnPropertyNames(new ChildClass()));
// ["prop", "method"]

列挙不可能なプロパティのみを取得する

ここでは Array.prototype.filter() 関数を使用して、 (Object.keys() で取得した) 列挙可能なキーを(Object.getOwnPropertyNames() で取得した)すべてのキーからフィルタリングし、出力として列挙不可能なキーのみを取得します。

js
const target = myObject;
const enumAndNonenum = Object.getOwnPropertyNames(target);
const enumOnly = new Set(Object.keys(target));
const nonenumOnly = enumAndNonenum.filter((key) => !enumOnly.has(key));

console.log(nonenumOnly);

仕様書

Specification
ECMAScript Language Specification
# sec-object.getownpropertynames

ブラウザーの互換性

BCD tables only load in the browser

関連情報