Symbol.toStringTag

Das wohlbekannte Symbol Symbol.toStringTag.

Einige Werte haben kein Symbol.toStringTag, aber spezielle toString()-Repräsentationen. Eine vollständige Liste finden Sie unter Object.prototype.toString().

Object.prototype.toString.call("foo"); // "[object String]"
Object.prototype.toString.call([1, 2]); // "[object Array]"
Object.prototype.toString.call(3); // "[object Number]"
Object.prototype.toString.call(true); // "[object Boolean]"
Object.prototype.toString.call(undefined); // "[object Undefined]"
Object.prototype.toString.call(null); // "[object Null]"
// ... and more

Die meisten eingebauten Objekte stellen ihre eigene [Symbol.toStringTag]-Eigenschaft zur Verfügung. Fast alle [Symbol.toStringTag]-Eigenschaften von eingebauten Objekten sind nicht schreibbar, nicht aufzählbar und konfigurierbar; die Ausnahme ist Iterator, das aus Kompatibilitätsgründen schreibbar ist.

Bei Konstruktor-Objekten wie Promise wird die Eigenschaft auf Constructor.prototype installiert, sodass alle Instanzen des Konstruktors [Symbol.toStringTag] erben und in einen String umgewandelt werden können. Bei Nicht-Konstruktor-Objekten wie Math und JSON wird die Eigenschaft als statische Eigenschaft installiert, sodass das Namensraumobjekt selbst in einen String umgewandelt werden kann. Manchmal stellt der Konstruktor auch seine eigene toString-Methode bereit (zum Beispiel Intl.Locale), in diesem Fall wird die [Symbol.toStringTag]-Eigenschaft nur verwendet, wenn Sie explizit Object.prototype.toString darauf aufrufen.

Object.prototype.toString.call(new Map()); // "[object Map]"
Object.prototype.toString.call(function* () {}); // "[object GeneratorFunction]"
Object.prototype.toString.call(Promise.resolve()); // "[object Promise]"
// ... and more

Wenn Sie Ihre eigene Klasse erstellen, verwendet JavaScript standardmäßig das Tag "Object":

class ValidatorClass {}

Object.prototype.toString.call(new ValidatorClass()); // "[object Object]"

Mit Hilfe von toStringTag können Sie jetzt Ihr eigenes benutzerdefiniertes Tag setzen:

class ValidatorClass {
  get [Symbol.toStringTag]() {
    return "Validator";
  }
}

Object.prototype.toString.call(new ValidatorClass()); // "[object Validator]"

Aufgrund einer WebIDL-Spezifikationsänderung Mitte 2020 fügen Browser eine Symbol.toStringTag-Eigenschaft zu allen DOM-Prototypobjekten hinzu. Um beispielsweise auf die Symbol.toStringTag-Eigenschaft auf HTMLButtonElement zuzugreifen:

const test = document.createElement("button");
test.toString(); // "[object HTMLButtonElement]"
test[Symbol.toStringTag]; // "HTMLButtonElement"

• Polyfill von Symbol.toStringTag in core-js
• Object.prototype.toString()