Symbol.prototype.valueOf()

valueOf() メソッドは、 Symbol オブジェクトのプリミティブ値を返します。

構文

Symbol().valueOf()

返値

指定された Symbol オブジェクトのプリミティブ値です。

解説

Symbol オブジェクトの valueOf() メソッドは、 Symbol オブジェクトのプリミティブ値を Symbol データ型として返します。

JavaScript はオブジェクトをプリミティブ値に変換するために valueOf() メソッドを呼び出します。 valueOf() メソッドを自分で呼び出す必要はほとんどありません。 JavaScript は、プリミティブ値が期待されているオブジェクトに遭遇したときに、自動的にこれを呼び出します。

valueOf() の使用

js

const sym = Symbol("example");
sym === sym.valueOf(); // true

仕様書

Specification
ECMAScript Language Specification
# sec-symbol.prototype.valueof

ブラウザーの互換性

BCD tables only load in the browser

関連情報