CKTIS / JavaScript
String.prototype.toString() — obtener un valor de cadena
String.prototype.toString() devuelve el valor primitivo de tipo cadena de una cadena o de un objeto String. No es un convertidor general: un valor this incompatible provoca un TypeError.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
stringValue.toString()
String.prototype.toString.call(value)El símbolo del catálogo String.toString se refiere aquí a String.prototype.toString(), llamada sobre un valor de cadena. No debe confundirse con la expresión String.toString(), que llama a un método de la propia función String.
El método no acepta parámetros. Si se aplica a una cadena primitiva, devuelve ese mismo valor; si se aplica a un objeto creado con new String(...), recupera el texto de la ranura interna [[StringData]]. El resultado es un valor primitivo de tipo string, no un objeto. El método integrado String.prototype.valueOf() devuelve el mismo valor.
El método no es genérico: String.prototype.toString.call(42) lanza un TypeError, al igual que las llamadas con null, undefined o un objeto ordinario sin [[StringData]]. Tener simplemente un método toString propio no basta. El ejemplo muestra receptores válidos y captura deliberadamente el error para un número.
Ejemplos
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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.