Object.getOwnPropertySymbols()

Object.getOwnPropertySymbols() メソッドは、与えられたオブジェクト上で直接見つかるシンボルプロパティすべての配列を返します。

構文

Object.getOwnPropertySymbols(obj)

引数

obj
シンボルプロパティが返されるオブジェクトです。

返値

与えられたオブジェクト上で直接見つかるシンボルプロパティすべての配列です。

解説

Object.getOwnPropertyNames() と同様、与えられたオブジェクトのすべてのシンボルプロパティをシンボルの配列として取得することができます。 Object.getOwnPropertyNames() 自体はオブジェクトのシンボルプロパティを含まず、文字列プロパティのみを含むことに注意して下さい。

すべてのオブジェクトが最初に自身のシンボルプロパティを持っているとは限らないので、 Object.getOwnPropertySymbols() は、オブジェクトにシンボルプロパティを設定しない限りは空の配列を返します。

getOwnPropertySymbols の使用

var obj = {};
var a = Symbol('a');
var b = Symbol.for('b');

obj[a] = 'localSymbol';
obj[b] = 'globalSymbol';

var objectSymbols = Object.getOwnPropertySymbols(obj);

console.log(objectSymbols.length); // 2
console.log(objectSymbols);        // [Symbol(a), Symbol(b)]
console.log(objectSymbols[0]);     // Symbol(a)

仕様書

仕様書
ECMAScript (ECMA-262)
Object.getOwnPropertySymbols の定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報