MDN self-hosted library · e01.org

Symbol.prototype.valueOf()

The valueOf() method of Symbol values returns this symbol value.

no runnable cells javascript-instance-method upstream source

The valueOf() method of Symbol values returns this symbol value.

JavaScript Demo: Symbol.prototype.valueOf()

```js interactive-example const symbol = Symbol("foo");

console.log(typeof Object(symbol)); // Expected output: "object"

console.log(typeof Object(symbol).valueOf()); // Expected output: "symbol"


## Syntax

```js-nolint
valueOf()

Parameters

None.

Return value

The primitive value of the specified Symbol object.

Description

The valueOf() method of Symbol returns the primitive value of a Symbol object as a Symbol data type.

JavaScript calls the valueOf() method to convert an object to a primitive value. You rarely need to invoke the valueOf() method yourself; JavaScript automatically invokes it when encountering an object where a primitive value is expected.

Examples

Using valueOf()

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

Specifications

Browser compatibility

See also

  • Object.prototype.valueOf()