Symbol.prototype.valueOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年9月.

valueOf() は Symbol 値のメソッドで、このシンボル値を返します。

試してみましょう

const symbol = Symbol("foo");

console.log(typeof Object(symbol));
// 予想される結果: "object"

console.log(typeof Object(symbol).valueOf());
// 予想される結果: "symbol"

構文

valueOf()

引数

なし。

返値

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

解説

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

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

例

valueOf() の使用

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

仕様書

Specification

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

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2025年11月13日 by MDN contributors.

View this page on GitHub • Report a problem with this content

Symbol.prototype.valueOf()

In this article

試してみましょう

構文

引数

返値

解説

例

valueOf() の使用

仕様書

ブラウザーの互換性

関連情報

Help improve MDN