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

const stringObj = new String("foo");

console.log(stringObj);
// Expected output: String { "foo" }

console.log(stringObj.toString());
// Expected output: "foo"

Syntax

js
toString()

Parameter

Keine.

Rückgabewert

Ein String, der den angegebenen String-Wert repräsentiert.

Beschreibung

Das String-Objekt überschreibt die toString-Methode von Object; es erbt nicht von Object.prototype.toString(). Für String-Werte gibt die toString-Methode den String selbst zurück (wenn es sich um einen primitiven Wert handelt) oder den String, den das String-Objekt umschließt. Sie hat die exakt gleiche Implementierung wie String.prototype.valueOf().

Die toString()-Methode erfordert, dass ihr this-Wert ein String-Primitiv oder ein Wrapper-Objekt ist. Sie löst einen TypeError aus, wenn andere this-Werte verwendet werden, ohne zu versuchen, diese in String-Werte umzuwandeln.

Da String keine [Symbol.toPrimitive]()-Methode besitzt, wird die toString()-Methode in JavaScript automatisch aufgerufen, wenn ein String-Objekt in einem Kontext verwendet wird, der einen String erwartet, wie etwa in einem Template-String. Allerdings verwenden String-Primitive die toString()-Methode nicht, um in Strings umgewandelt 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 an:

js
const x = new String("Hello world");

console.log(x.toString()); // "Hello world"

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.tostring

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch