String.prototype.toString()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die toString()
-Methode von String
-Werten gibt diesen String-Wert zurück.
Probieren Sie es aus
Syntax
toString()
Parameter
Keine.
Rückgabewert
Ein String, der den angegebenen String-Wert darstellt.
Beschreibung
Das String
-Objekt überschreibt die toString
-Methode von Object
; es erbt nicht
Object.prototype.toString()
. Für String
-Werte gibt die toString
-Methode den String selbst zurück (wenn es ein primitiver Wert ist) oder den String, den das String
-Objekt umschließt. Sie hat die genau gleiche Implementierung wie String.prototype.valueOf()
.
Die toString()
-Methode erfordert, dass ihr this
-Wert ein primitiver String
oder ein Wrapper-Objekt ist. Bei anderen this
-Werten löst sie einen TypeError
aus, ohne zu versuchen, diese in String-Werte zu konvertieren.
Da String
keine [Symbol.toPrimitive]()
-Methode hat, ruft JavaScript automatisch die toString()
-Methode auf, wenn ein String
-Objekt in einem Kontext verwendet wird, der einen String erwartet, wie z.B. in einem Template-String. String-Primitivwerte konsultieren jedoch nicht die toString()
-Methode, um in Strings konvertiert zu werden — da sie bereits Strings sind, wird keine Umwandlung durchgeführt.
String.prototype.toString = () => "Overridden";
console.log(`${"foo"}`); // "foo"
console.log(`${new String("foo")}`); // "Overridden"
Beispiele
Verwendung von toString()
Das folgende Beispiel zeigt den String-Wert eines String
-Objekts:
const x = new String("Hello world");
console.log(x.toString()); // "Hello world"
Spezifikationen
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.tostring |
Browser-Kompatibilität
BCD tables only load in the browser