String.prototype.valueOf()

O método valueOf() retorna o valor primitivo de um objeto String.

Sintaxe

str.valueOf()

Valor retornado

Uma string representando o valor primitivo de um objeto String.

Descrição

O método valueOf() do objeto String retorna o valor primitivo de um objeto String como um dado do tipo string. Esse valor é equivalente a String.prototype.toString().

Esse método é normalmente chamado internamente pelo JavaScript e não fica explícito no código.

Exemplos

Usando valueOf()

var x = new String('Olá, mundo');
console.log(x.valueOf()); // retorna 'Olá, mundo'

Especificações

Especificação Status Comentário
ECMAScript 1st Edition (ECMA-262) Padrão Definição inicial implementada no JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'String.prototype.valueOf' in that specification.
Padrão
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'String.prototype.valueOf' in that specification.
Padrão
ECMAScript (ECMA-262)
The definition of 'String.prototype.valueOf' in that specification.
Padrão em tempo real

BCD tables only load in the browser

Veja também