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.