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 Latest Draft (ECMA-262) The definition of 'String.prototype.valueOf' in that specification. |
Draft |
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.
Feature | Chrome | Firefox | Edge | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Feature | Android | Chrome for Android | Edge mobile | Firefox for Android | IE mobile | Opera Android | iOS Safari |
---|---|---|---|---|---|---|---|
Basic Support | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
See also
Document Tags and Contributors
Tags:
Contributors to this page:
fscholz,
jameshkramer,
eduardoboucas,
Mingun,
Sheppy,
evilpie,
Mgjbot,
Diablownik,
Maian,
Dria
Last updated by:
fscholz,