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 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
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.
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:
const x = new String("Hello world");
console.log(x.toString()); // "Hello world"
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.tostring |