Symbol.toStringTag

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2017 browserübergreifend verfügbar.

Die statische Dateneigenschaft Symbol.toStringTag repräsentiert das bekannte Symbol Symbol.toStringTag. Object.prototype.toString() sucht dieses Symbol im this-Wert der Eigenschaft, die eine Zeichenfolge enthält, die den Typ des Objekts darstellt.

In diesem Artikel

Probieren Sie es aus

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

console.log(Object.prototype.toString.call(new ValidatorClass()));
// Expected output: "[object Validator]"

Wert

Das bekannte Symbol Symbol.toStringTag.

Eigenschaften von Symbol.toStringTag

Schreibbar	nein
Aufzählbar	nein
Konfigurierbar	nein

Beispiele

Standard-Tags

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

js
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

Eingebaute toStringTag-Symbole

Die meisten eingebauten Objekte stellen ihre eigene [Symbol.toStringTag]-Eigenschaft bereit. Fast alle [Symbol.toStringTag]-Eigenschaften der eingebauten Objekte sind nicht beschreibbar, nicht aufzählbar und konfigurierbar; die Ausnahme ist Iterator, die aus Kompatibilitätsgründen beschreibbar ist.

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

js
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

Benutzerdefiniertes Tag mit toStringTag

Beim Erstellen Ihrer eigenen Klasse verwendet JavaScript standardmäßig das "Object"-Tag:

js
class ValidatorClass {}

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

Nun, mit Hilfe von toStringTag können Sie Ihr eigenes benutzerdefiniertes Tag festlegen:

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

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

toStringTag verfügbar auf allen DOM-Prototypenobjekten

Aufgrund einer WebIDL-Spezifikationsänderung in der Mitte des Jahres 2020 fügen Browser eine Symbol.toStringTag-Eigenschaft zu allen DOM-Prototypenobjekten hinzu. Um zum Beispiel die Symbol.toStringTag-Eigenschaft auf HTMLButtonElement zuzugreifen:

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

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Symbol
Konstruktor
1. Symbol()
Statische Methoden
1. for()
2. keyFor()
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. description
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor