Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
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.
DietoString()-Methode vonString-Werten gibt diesen Zeichenfolgenwert zurück.
In diesem Artikel
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
DasString-Objekt überschreibt dietoString-Methode vonObject; es erbt nichtObject.prototype.toString(). FürString-Werte gibt dietoString-Methode die Zeichenfolge selbst zurück (wenn es sich um ein primitives handelt) oder die Zeichenfolge, die dasString-Objekt umschließt. Sie hat die exakt gleiche Implementierung wieString.prototype.valueOf().
DietoString()-Methode erfordert, dass ihrthis-Wert ein primitiverString oder ein Wrapper-Objekt ist. Sie wirft einenTypeError für anderethis-Werte aus, ohne zu versuchen, sie zu Zeichenfolgenwerten zu erzwingen.
DaString keine[Symbol.toPrimitive]()-Methode hat, ruft JavaScript dietoString()-Methode automatisch auf, wenn einString-Objekt in einem Kontext verwendet wird, der eine Zeichenfolge erwartet, wie zum Beispiel in einemTemplate-Literal. Allerdings konsultierenString-Primitive dietoString()-Methode nicht, umzu 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 einesString-Objekts:
const x = new String("Hello world");console.log(x.toString()); // "Hello world"Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-string.prototype.tostring> |