この記事は編集レビューを必要としています。ぜひご協力ください。
これは Harmony(ECMAScript 6) 提案の一部であり、実験段階の技術です。
この技術の仕様は安定していません。ブラウザ互換性の一覧表を確認してください。またこれらの構文や動作は、仕様変更などにより、新しいバージョンのブラウザでは変更される可能性があるという点に注意してください。
[@@toPrimitive]()メソッドは、Symbol オブジェクトをプリミティブ値に変換します。
構文
Symbol()[Symbol.toPrimitive](hint);
説明
Symbol オブジェクトの[@@toPrimitive]()メソッドは、Symbolデータ型としてSymbolオブジェクトのプリミティブ値を返します。hint引数は使われません。
JavaScriptはオブジェクトをプリミティブ値に変換するために [@@toPrimitive]()メソッドを呼び出します。[@@toPrimitive]()メソッドを自分で呼び出す必要はほとんどありません。JavaScriptは、プリミティブ値が期待されているオブジェクトに遭遇したときに、自動的にこれを呼び出します。
仕様
| 仕様 | 状態 | コメント |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Symbol.prototype.@@toPrimitive' in that specification. |
Standard | Initial definition. |
ブラウザ実装状況
| Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| Basic support | ? | 44.0 (44.0) | ? | ? | ? |
| Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|
| Basic support | ? | ? | 44.0 (44.0) | ? | ? | ? |