Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

String.prototype.toString() — obter um valor de cadeia de caracteres

String.prototype.toString() devolve o valor primitivo de cadeia de caracteres de uma cadeia ou de um objeto String. Não é um conversor geral: um valor this incompatível provoca um TypeError.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

stringValue.toString()
String.prototype.toString.call(value)

O símbolo de catálogo String.toString refere-se aqui a String.prototype.toString(), chamada sobre um valor de cadeia de caracteres. Não a confunda com a expressão String.toString(), que chama um método da própria função String.

O método não recebe parâmetros. Para uma cadeia primitiva, devolve esse mesmo valor; para um objeto criado com new String(...), obtém o texto do slot interno [[StringData]]. O resultado é um valor primitivo do tipo string, não um objeto. O método integrado String.prototype.valueOf() devolve o mesmo valor.

O método não é genérico: String.prototype.toString.call(42) lança um TypeError, tal como as chamadas com null, undefined ou um objeto comum sem [[StringData]]. Ter apenas um método toString próprio não é suficiente. O exemplo mostra recetores válidos e captura deliberadamente o erro para um número.

Exemplos

const text = "hello";
const wrapped = new String(text);
const result = wrapped.toString();

console.log(text.toString() === text);
console.log(result, typeof result);
console.log(result === wrapped.valueOf());

try {
  String.prototype.toString.call(42);
} catch (error) {
  console.log(error instanceof TypeError);
}

Resultado

true
hello string
true
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes