Object.getOwnPropertySymbols()

概要

引数で与えられたオブジェクト上で直接見つかったすべてのsymbolプロパティの配列を返します。

構文

Object.getOwnPropertySymbols(obj)

引数

obj
symbolプロパティが返されるオブジェクト

説明

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

すべてのオブジェクトが最初に自身のシンボルプロパティを持たないので、Object.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 2015 (6th Edition, ECMA-262)
Object.getOwnPropertySymbols の定義
標準 Initial definition.

ブラウザ実装状況

現在、互換性データを可読形式の JSON フォーマットに置き換えているところです。 この互換性一覧は古い形式を使っており、これに含まれるデータの置き換えが済んでいません。 手助けしていただける場合は、こちらから!
機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート (有) 36.0 (36.0) 未サポート (有) 未サポート
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート (有) (有) 36.0 (36.0) 未サポート 未サポート 未サポート

関連情報