String.prototype.valueOf()

The valueOf() method returns the primitive value of a String object.

Syntax

str.valueOf()

Return value

A string representing the primitive value of a given String object.

Description

The valueOf() method of String returns the primitive value of a String object as a string data type. This value is equivalent to String.prototype.toString().

This method is usually called internally by JavaScript and not explicitly in code.

Examples

Using valueOf()

var x = new String('Hello world');
console.log(x.valueOf()); // Displays 'Hello world'

Specifications

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

See also

• String.prototype.toString()
• Object.prototype.valueOf()