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.