Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Symbol.toStringTag — una etiqueta de objeto personalizada

Symbol.toStringTag es un símbolo conocido que se usa como clave de propiedad para proporcionar la etiqueta que aparece en el resultado de Object.prototype.toString(). Cambia la descripción de un objeto, no su tipo real.

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

const value = { [Symbol.toStringTag]: "Widget" };
Object.prototype.toString.call(value);

Symbol.toStringTag es un símbolo conocido, no un método. Una propiedad de objeto con esta clave puede proporcionar la cadena que Object.prototype.toString.call(value) utiliza para producir un resultado como [object Widget]. La clave de símbolo no es lo mismo que la clave de cadena "Symbol.toStringTag".

El método también lee esta propiedad a través de la cadena de prototipos. Si su valor no es una cadena, utiliza la etiqueta predeterminada, como Object para un objeto ordinario; no convierte el valor en una cadena. Puede ejecutarse un getter, y cualquier excepción que lance se propaga.

La etiqueta es descriptiva, no una comprobación fiable del tipo: se puede falsificar. No cambia typeof, el prototipo ni las capacidades internas del objeto. Tampoco reemplaza un método toString() personalizado ni controla en general la conversión a un valor primitivo; esa es la función de Symbol.toPrimitive.

Ejemplos

const item = { [Symbol.toStringTag]: "Widget" };
console.log(Object.prototype.toString.call(item));

item[Symbol.toStringTag] = 42;
console.log(Object.prototype.toString.call(item));
console.log(typeof item);

Resultado

[object Widget]
[object Object]
object

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.

Fuentes