CKTIS / JavaScript
String — conversión explícita a texto
String(value) convierte un valor en una cadena primitiva. Si se llama sin argumentos, devuelve una cadena vacía. Si la conversión se realiza correctamente, new String(value) crea un objeto envoltorio, no un valor primitivo.
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
String(value)
String()
new String(value)String es una función integrada de ECMAScript, no una API del navegador. La llamada String(value) devuelve una cadena primitiva si la conversión se realiza correctamente. El tipo String representa secuencias inmutables de unidades de código de 16 bits, normalmente interpretadas como UTF-16; una letra visible u otro carácter no tiene por qué corresponder a una sola unidad de código.
Omitir el argumento no es lo mismo que pasar undefined: String() devuelve "", pero String(undefined) devuelve "undefined". Del mismo modo, String(null) produce "null" y String(42) produce "42". Un argumento Symbol directo recibe un tratamiento especial: String(Symbol("tag")) devuelve "Symbol(tag)".
Este tratamiento especial solo se aplica a las llamadas sin new: new String(Symbol("tag")) lanza una excepción TypeError en lugar de crear un objeto envoltorio. Si la conversión se realiza correctamente, new String(value) crea un objeto envoltorio. Por eso, typeof String("hello") produce "string", mientras que typeof new String("hello") produce "object". La comparación estricta de estos valores con === produce false. Para una conversión normal a texto, usa String(value) sin new.
Al convertir un objeto, se pueden invocar sus propios mecanismos de conversión, como [Symbol.toPrimitive] o toString, y puede producirse una excepción. String(value) no es una serialización JSON ni una forma de mostrar de manera segura objetos arbitrarios que no sean de confianza sin ejecutar su código.
Ejemplos
console.log(JSON.stringify([String(), String(undefined), String(null), String(42)]));
console.log(String(Symbol("tag")));
const text = String("hello");
const wrapped = new String("hello");
console.log(typeof text, typeof wrapped);
console.log(text === wrapped);Resultado
["","undefined","null","42"] Symbol(tag) string object false
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.