Firefox Tomorrow

javascript instance method

String.prototype.valueOf()

View on MDN ↗

The valueOf() method of String values returns this string value.

Interactive exampleOpen the canonical MDN source to run this embedded demo.
const stringObj = new String("foo");

console.log(stringObj);
// Expected output: String { "foo" }

console.log(stringObj.valueOf());
// Expected output: "foo"

Syntax

valueOf()

Parameters

None.

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 toString().

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

Examples

Using valueOf()

const x = new String("Hello world");
console.log(x.valueOf()); // 'Hello world'

Specifications

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also