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 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 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.
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 |