String.prototype.toString() - JavaScript | MDN

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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

Parameter

Keine.

Rückgabewert

Eine Zeichenkette, die den angegebenen Zeichenkettenwert darstellt.

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 die Zeichenkette selbst zurück (wenn es sich um ein einfaches Zeichenkettenprimiti handelt) oder die Zeichenkette, 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 String-Primitive oder Wrapper-Objekt ist. Sie löst einen TypeError für andere this-Werte aus, ohne zu versuchen, sie zu Zeichenkettenwerten zu zwingen.

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 Zeichenkette erwartet, wie zum Beispiel in einem Template-Literal. Allerdings konsultieren Zeichenkettenprimitivwerte nicht die toString()-Methode, um in Zeichenketten umgewandelt zu werden – da sie bereits Zeichenketten sind, wird keine Konvertierung 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 Zeichenkettenwert eines String-Objekts:

js

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

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch

Help improve MDN

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.