JavaScript String valueOf() method

Definition and usage

valueOf() The method returns the original value of the string.

valueOf() The method does not change the original string.

valueOf() The method can be used to convert a string object to a string.

See also:

toString() method

Note

valueOf() The method is the default method of JavaScript strings.

JavaScript uses it internally.

Normally, you will not use it in the code.

Instance

Example 1

Get the value of the text:

let text = "Hello World!";
let result = text.valueOf();

Try it yourself

Is equivalent to:

let text = "Hello World!";
let result = text;

Try it yourself

Example 2

Get the value of the String object:

let text = new String("Hello World!");
let result = text.valueOf();

Try it yourself

Syntax

string.valueOf()

Parameter

No parameters.

Return value

Type Description
String The original value of the string.

Thrown

Exception Description
TypeError An exception is thrown when the object calling this method is not a String.

Browser support

valueOf() Is an ECMAScript1 (ES1) feature.

All browsers support ES1 (JavaScript 1997):

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
Support Support Support Support Support Support

Related pages

JavaScript string

JavaScript string methods

JavaScript string search