string.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

Specification	Status	Comment
ECMAScript 1st Edition (ECMA-262)	Standard	Initial definition. Implemented in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262) The definition of 'String.prototype.valueOf' in that specification.	Standard
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'String.prototype.valueOf' in that specification.	Standard
ECMAScript 2017 Draft (ECMA-262) The definition of 'String.prototype.valueOf' in that specification.	Draft

Browser compatibility

See also

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