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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
toString

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch