Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Symbol.toStringTag — un tag personalizzato per gli oggetti

Symbol.toStringTag è un simbolo noto usato come chiave di proprietà per fornire il tag nell’output di Object.prototype.toString(). Cambia la descrizione di un oggetto, non il suo tipo effettivo.

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

Sintassi

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

Symbol.toStringTag è un simbolo noto, non un metodo. Una proprietà dell’oggetto con questa chiave può fornire la stringa che Object.prototype.toString.call(value) usa per produrre un risultato come [object Widget]. La chiave simbolo non è la stessa della chiave stringa "Symbol.toStringTag".

Il metodo legge questa proprietà anche lungo la catena dei prototipi. Se il suo valore non è una stringa, usa il tag predefinito, per esempio Object per un oggetto ordinario; non converte il valore in una stringa. Un getter può essere eseguito e qualsiasi eccezione generata viene propagata.

Il tag è descrittivo, non è un controllo affidabile del tipo: può essere falsificato. Non modifica typeof, il prototipo o le capacità interne dell’oggetto. Inoltre, non sostituisce un metodo toString() personalizzato né controlla in generale la conversione in un valore primitivo: questo è il ruolo di Symbol.toPrimitive.

Esempi

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);

Risultato

[object Widget]
[object Object]
object

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti