Object.getOwnPropertySymbols()
Object.getOwnPropertySymbols()
メソッドは、与えられたオブジェクト上で直接見つかるシンボルプロパティすべての配列を返します。
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
構文
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)
仕様書
ブラウザーの互換性
BCD tables only load in the browser