Symbol.prototype.description
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
Die description
-Zugriffs-Eigenschaft von Symbol
-Werten gibt eine Zeichenfolge zurück, die die Beschreibung dieses Symbols enthält, oder undefined
, wenn das Symbol keine Beschreibung hat.
Probieren Sie es aus
console.log(Symbol("desc").description);
// Expected output: "desc"
console.log(Symbol.iterator.description);
// Expected output: "Symbol.iterator"
console.log(Symbol.for("foo").description);
// Expected output: "foo"
console.log(`${Symbol("foo").description}bar`);
// Expected output: "foobar"
Beschreibung
Symbol
-Objekte können mit einer optionalen Beschreibung erstellt werden, die zum Debuggen verwendet werden kann, aber nicht, um auf das Symbol selbst zuzugreifen. Die Eigenschaft Symbol.prototype.description
kann verwendet werden, um diese Beschreibung zu lesen. Sie unterscheidet sich von Symbol.prototype.toString()
, da sie nicht die umschließende Zeichenfolge "Symbol()"
enthält. Siehe die Beispiele.
Beispiele
Nutzung der description
Symbol("desc").toString(); // "Symbol(desc)"
Symbol("desc").description; // "desc"
Symbol("").description; // ""
Symbol().description; // undefined
// well-known symbols
Symbol.iterator.toString(); // "Symbol(Symbol.iterator)"
Symbol.iterator.description; // "Symbol.iterator"
// global symbols
Symbol.for("foo").toString(); // "Symbol(foo)"
Symbol.for("foo").description; // "foo"
Spezifikationen
Specification |
---|
ECMAScript® 2026 Language Specification # sec-symbol.prototype.description |