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

js
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.

js
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:

js
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

Siehe auch