String.prototype.valueOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

Try it

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

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

Examples

Using valueOf()

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

Specifications

Specification

ECMAScript® 2027 Language Specification
# sec-string.prototype.valueof

Browser compatibility

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Jul 10, 2025 by MDN contributors.

View this page on GitHub • Report a problem with this content

Standard built-in objects
String
Constructor
1. String()
Static methods
Instance methods
Instance properties
1. length
Inheritance
Object/Function
Static methods
Static properties
Instance methods
Instance properties
1. __proto__
2. constructor