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.

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

Experimente

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

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

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

Especificações

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

Compatibilidade com navegadores

Veja também