Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
String()-Konstruktor
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.
DerString()-Konstruktor erstelltString-Objekte. Wird er als Funktion aufgerufen, gibt er primitive Werte vom Typ String zurück.
In diesem Artikel
Syntax
new String(thing)String(thing)Hinweis:String() kann mit oder ohnenew aufgerufen werden, jedoch mit unterschiedlichen Effekten. SieheRückgabewert.
Parameter
thingAlles, was in einen String umgewandelt werden soll.
Rückgabewert
WennString() als Funktion (ohnenew) aufgerufen wird, gibt esvalue zurück,in einen String-Primitive zwangsweise umgewandelt. Insbesondere werdenSymbol-Werte in"Symbol(description)" umgewandelt, wobeidescription dieBeschreibung des Symbols ist, anstelle eines Fehlers.
WennString() als Konstruktor (mitnew) aufgerufen wird, wirdvalue in ein String-Primitive umgewandelt (ohne spezielle Symbolbehandlung) und gibt ein umhüllendesString-Objekt zurück, daskein Primitivwert ist.
Warnung:Sie sollten selten denString-Konstruktor verwenden.
Beispiele
>String-Konstruktor und String-Funktion
Die String-Funktion und der String-Konstruktor erzeugen unterschiedliche Ergebnisse:
const a = new String("Hello world"); // a === "Hello world" is falseconst b = String("Hello world"); // b === "Hello world" is truea instanceof String; // is trueb instanceof String; // is falsetypeof a; // "object"typeof b; // "string"Hier erzeugt die Funktion einen String (denprimitiven Typ), wie versprochen.Der Konstruktor jedoch erzeugt eine Instanz des Typs String (einen Objekt-Wrapper), und deshalb möchten Sie den String-Konstruktor in der Regel überhaupt nicht verwenden.
Verwendung von String() zum Stringifizieren eines Symbols
String() ist der einzige Fall, bei dem ein Symbol in einen String umgewandelt werden kann, ohne einen Fehler auszulösen, da es sehr explizit ist.
const sym = Symbol("example");`${sym}`; // TypeError: Cannot convert a Symbol value to a string"" + sym; // TypeError: Cannot convert a Symbol value to a string"".concat(sym); // TypeError: Cannot convert a Symbol value to a stringconst sym = Symbol("example");String(sym); // "Symbol(example)"Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification> # sec-string-constructor> |
Browser-Kompatibilität
Siehe auch
- Zahlen und Strings Leitfaden