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

仕様書

仕様書
ECMAScript (ECMA-262)
Symbol.prototype.@@toPrimitive の定義

ブラウザーの互換性

Update compatibility data on GitHub
デスクトップモバイルサーバー
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewAndroid 版 ChromeAndroid 版 FirefoxAndroid 版 OperaiOSのSafariSamsung InternetNode.js
@@toPrimitiveChrome 完全対応 47Edge 完全対応 15Firefox 完全対応 44IE 未対応 なしOpera 完全対応 34Safari 完全対応 10WebView Android 完全対応 47Chrome Android 完全対応 47Firefox Android 完全対応 44Opera Android 完全対応 34Safari iOS 完全対応 10Samsung Internet Android 完全対応 5.0nodejs 完全対応 6.0.0

凡例

完全対応  
完全対応
未対応  
未対応

関連情報