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 String-Wert 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
Ein String, der den angegebenen String-Wert 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 den String selbst zurück (wenn es sich um ein primitives Element handelt) oder den String, den das String-Objekt umschließt. Die Implementierung ist identisch mit String.prototype.valueOf().
Die toString() Methode erfordert, dass ihr this-Wert ein String-Primitiv oder Wrapper-Objekt ist. Sie löst einen TypeError für andere this-Werte aus, ohne zu versuchen, sie in String-Werte zu zwingen.
Da String keine [Symbol.toPrimitive]() Methode besitzt, ruft JavaScript die toString() Methode automatisch auf, wenn ein String Objekt in einem Kontext verwendet wird, der einen String erwartet, wie zum Beispiel in einem Template-Literal. Allerdings konsultieren String primitive Werte die toString() Methode nicht, um in Strings umgewandelt zu werden — da sie bereits Strings 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 String-Wert 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 |