CKTIS / JavaScript
String.prototype.toString() — einen Stringwert abrufen
String.prototype.toString() gibt den primitiven Stringwert eines Strings oder String-Objekts zurück. Die Methode ist kein allgemeiner Konverter: Bei einem inkompatiblen this-Wert wird ein TypeError ausgelöst.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
stringValue.toString()
String.prototype.toString.call(value)Das Katalogsymbol String.toString bezeichnet hier String.prototype.toString(), aufgerufen auf einem Stringwert. Verwechseln Sie die Methode nicht mit dem Ausdruck String.toString(), der eine Methode auf der Funktion String selbst aufruft.
Die Methode nimmt keine Parameter entgegen. Bei einem primitiven String gibt sie denselben Wert zurück; bei einem mit new String(...) erstellten Objekt ruft sie den Text aus dem internen Slot [[StringData]] ab. Das Ergebnis ist ein primitiver Wert vom Typ string, kein Objekt. Die eingebaute Methode String.prototype.valueOf() gibt denselben Wert zurück.
Die Methode ist nicht generisch: String.prototype.toString.call(42) löst ebenso einen TypeError aus wie Aufrufe mit null, undefined oder einem gewöhnlichen Objekt ohne [[StringData]]. Eine eigene toString-Methode allein reicht nicht aus. Das Beispiel zeigt gültige Empfänger und fängt den Fehler für eine Zahl absichtlich ab.
Beispiele
const text = "hello";
const wrapped = new String(text);
const result = wrapped.toString();
console.log(text.toString() === text);
console.log(result, typeof result);
console.log(result === wrapped.valueOf());
try {
String.prototype.toString.call(42);
} catch (error) {
console.log(error instanceof TypeError);
}Ergebnis
true hello string true true
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.