Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 ⁨Juli 2015⁩.

Die toString()-Methode von String-Werten gibt diesen Zeichenfolgenwert 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

Eine Zeichenfolge, die den angegebenen Zeichenfolgenwert 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 die Zeichenfolge selbst zurück (wenn es sich um ein primitives handelt) oder die Zeichenfolge, die das String-Objekt umschließt. Sie hat die exakt gleiche Implementierung wie String.prototype.valueOf().

Die toString()-Methode erfordert, dass ihr this-Wert ein primitiver String oder ein Wrapper-Objekt ist. Sie wirft einen TypeError für andere this-Werte aus, ohne zu versuchen, sie zu Zeichenfolgenwerten zu erzwingen.

Da String keine [Symbol.toPrimitive]()-Methode hat, ruft JavaScript die toString()-Methode automatisch auf, wenn ein String-Objekt in einem Kontext verwendet wird, der eine Zeichenfolge erwartet, wie zum Beispiel in einem Template-Literal. Allerdings konsultieren String-Primitive die toString()-Methode nicht, um zu Zeichenfolgen umgewandelt zu werden — da sie bereits Zeichenfolgen 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 Zeichenfolgenwert eines String-Objekts:

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

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch