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 |