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 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
toString()
Parameter
Keine.
Rückgabewert
Eine Zeichenkette, die den angegebenen Zeichenkettenwert 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 die Zeichenkette selbst zurück (wenn es sich um einen primitiven Typ 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 primitiver Typ oder Wrapper-Objekt ist. Sie wirft einen TypeError für andere this Werte, ohne zu versuchen, sie in Zeichenkettenwerte umzuwandeln.
Da String keine [Symbol.toPrimitive]() Methode hat, ruft JavaScript automatisch die toString() Methode auf, wenn ein String Objekt in einem Kontext verwendet wird, der eine Zeichenkette erwartet, wie zum Beispiel in einem Template-String. String primitive Werte beziehen sich jedoch nicht auf die toString() Methode, um in Zeichenketten umgewandelt zu werden — da sie bereits Zeichenketten sind, wird keine Umwandlung durchgeführt.
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:
const x = new String("Hello world");
console.log(x.toString()); // "Hello world"
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.tostring |