Symbol.prototype.valueOf()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2015年9月以降、すべてのブラウザーで利用可能です。
valueOf() は Symbol 値のメソッドで、このシンボル値を返します。
試してみましょう
const symbol = Symbol("foo");
console.log(typeof Object(symbol));
// 予想される結果: "object"
console.log(typeof Object(symbol).valueOf());
// 予想される結果: "symbol"
構文
js
valueOf()
引数
なし。
返値
指定された Symbol オブジェクトのプリミティブ値です。
解説
valueOf() は Symbol オブジェクトのメソッドで、 Symbol オブジェクトのプリミティブ値をシンボルデータ型として返します。
JavaScript はオブジェクトをプリミティブ値に変換するために valueOf() メソッドを呼び出します。valueOf() メソッドを自分で呼び出す必要はほとんどありません。JavaScript は、プリミティブ値が期待されているオブジェクトに遭遇したときに、自動的にこれを呼び出します。
例
valueOf() の使用
js
const sym = Symbol("example");
sym === sym.valueOf(); // true
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-symbol.prototype.valueof |