Symbol.prototype[@@toPrimitive]
[@@toPrimitive]()
メソッドは、 Symbol オブジェクトをプリミティブ値に変換します。
構文
Symbol()[Symbol.toPrimitive](hint)
返値
Symbol
オブジェクトで指定されたプリミティブ値です。
解説
Symbol
オブジェクトの [@@toPrimitive]()
メソッドは、 Symbol オブジェクトのプリミティブ値を Symbol データ型として返します。 hint
引数は使われません。
JavaScript はオブジェクトをプリミティブ値に変換するために [@@toPrimitive]()
メソッドを呼び出します。 [@@toPrimitive]()
メソッドを自分で呼び出す必要はほとんどありません。 JavaScript は、プリミティブ値が期待されているオブジェクトに遭遇したときに、自動的にこれを呼び出します。
例
@@toPrimitive の使用
const sym = Symbol("example");
sym === sym[Symbol.toPrimitive](); // true
仕様書
Specification |
---|
ECMAScript Language Specification # sec-symbol.prototype-@@toprimitive |
ブラウザーの互換性
BCD tables only load in the browser