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 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 den String selbst zurück (wenn es sich um einen primitiven Wert handelt) oder den String, den 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
-Primitiv oder ein Wrapper-Objekt ist. Sie löst einen TypeError
aus, wenn andere this
-Werte verwendet werden, ohne zu versuchen, diese in String-Werte umzuwandeln.
Da String
keine [Symbol.toPrimitive]()
-Methode besitzt, wird die toString()
-Methode in JavaScript automatisch aufgerufen, wenn ein String
-Objekt in einem Kontext verwendet wird, der einen String erwartet, wie etwa in einem Template-String. Allerdings verwenden String
-Primitive 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 an:
const x = new String("Hello world");
console.log(x.toString()); // "Hello world"
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-string.prototype.tostring |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
toString |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support