CKTIS / JavaScript
String — explizite Umwandlung in Text
String(value) wandelt einen Wert in eine primitive Zeichenfolge um. Ein Aufruf ohne Argument gibt eine leere Zeichenfolge zurück. Wenn die Umwandlung gelingt, erstellt new String(value) ein Wrapper-Objekt statt eines primitiven Werts.
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
String(value)
String()
new String(value)String ist eine integrierte ECMAScript-Funktion und keine Browser-API. Der Aufruf String(value) gibt eine primitive Zeichenfolge zurück, sofern die Umwandlung gelingt. Der Typ String stellt unveränderliche Folgen von 16-Bit-Codeeinheiten dar, die üblicherweise als UTF-16 interpretiert werden; ein sichtbarer Buchstabe oder ein anderes Zeichen entspricht nicht unbedingt einer Codeeinheit.
Ein fehlendes Argument unterscheidet sich von der Übergabe von undefined: String() gibt "" zurück, String(undefined) dagegen "undefined". Ebenso ergibt String(null) den Wert "null" und String(42) den Wert "42". Ein direkt übergebenes Symbol wird speziell behandelt: String(Symbol("tag")) gibt "Symbol(tag)" zurück.
Diese Sonderbehandlung gilt nur beim Aufruf ohne new: new String(Symbol("tag")) löst einen TypeError aus, statt ein Wrapper-Objekt zu erstellen. Wenn die Umwandlung gelingt, erstellt new String(value) ein Wrapper-Objekt. Daher ergibt typeof String("hello") den Wert "string", während typeof new String("hello") den Wert "object" ergibt. Ein strenger Vergleich dieser Werte mit === ergibt false. Verwende für die gewöhnliche Textumwandlung String(value) ohne new.
Bei der Umwandlung eines Objekts können dessen eigene Umwandlungsmechanismen wie [Symbol.toPrimitive] oder toString aufgerufen werden; außerdem kann eine Ausnahme ausgelöst werden. String(value) ist weder eine JSON-Serialisierung noch eine Möglichkeit, beliebige nicht vertrauenswürdige Objekte sicher anzuzeigen, ohne ihren Code auszuführen.
Beispiele
console.log(JSON.stringify([String(), String(undefined), String(null), String(42)]));
console.log(String(Symbol("tag")));
const text = String("hello");
const wrapped = new String("hello");
console.log(typeof text, typeof wrapped);
console.log(text === wrapped);Ergebnis
["","undefined","null","42"] Symbol(tag) string object false
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.