CKTIS / JavaScript
Symbol.toStringTag — ein eigenes Objekt-Tag
Symbol.toStringTag ist ein bekanntes Symbol, das als Eigenschaftsschlüssel das Tag für die Ausgabe von Object.prototype.toString() bereitstellt. Es ändert die Beschreibung eines Objekts, nicht dessen tatsächlichen Typ.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
const value = { [Symbol.toStringTag]: "Widget" };
Object.prototype.toString.call(value);Symbol.toStringTag ist ein bekanntes Symbol, keine Methode. Eine Objekteigenschaft mit diesem Schlüssel kann die Zeichenfolge liefern, die Object.prototype.toString.call(value) für ein Ergebnis wie [object Widget] verwendet. Der Symbolschlüssel ist nicht dasselbe wie der Zeichenfolgeschlüssel "Symbol.toStringTag".
Die Methode liest diese Eigenschaft auch entlang der Prototypenkette aus. Ist ihr Wert keine Zeichenfolge, verwendet sie das Standard-Tag, etwa Object bei einem gewöhnlichen Objekt; sie wandelt den Wert nicht in eine Zeichenfolge um. Ein Getter kann ausgeführt werden, und jede von ihm ausgelöste Ausnahme wird weitergegeben.
Das Tag dient der Beschreibung und ist keine verlässliche Typprüfung: Es lässt sich vortäuschen. Es ändert weder typeof noch den Prototyp oder die internen Fähigkeiten des Objekts. Es ersetzt auch keine eigene toString()-Methode und steuert die Umwandlung in primitive Werte nicht allgemein – dafür ist Symbol.toPrimitive zuständig.
Beispiele
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);Ergebnis
[object Widget] [object Object] object
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.