← 返回首页

String()-Konstruktor - JavaScript | MDN

Seitenleiste umschalten

Farbschema

Systemeinstellung
Hell
Dunkel

Deutsch

Sprache merken Mehr erfahren

String()-Konstruktor

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Der String()-Konstruktor erstellt String-Objekte. Wird er als Funktion aufgerufen, gibt er primitive Werte vom Typ String zurück.

In diesem Artikel

Syntax

js
new String(thing)
String(thing)

Hinweis: String() kann mit oder ohne new aufgerufen werden, jedoch mit unterschiedlichen Effekten. Siehe Rückgabewert.

Parameter

thing

Alles, was in einen String umgewandelt werden soll.

Rückgabewert

Wenn String() als Funktion (ohne new) aufgerufen wird, gibt es value zurück, in einen String-Primitive zwangsweise umgewandelt. Insbesondere werden Symbol-Werte in "Symbol(description)" umgewandelt, wobei description die Beschreibung des Symbols ist, anstelle eines Fehlers.

Wenn String() als Konstruktor (mit new) aufgerufen wird, wird value in ein String-Primitive umgewandelt (ohne spezielle Symbolbehandlung) und gibt ein umhüllendes String-Objekt zurück, das kein Primitivwert ist.

Warnung: Sie sollten selten den String-Konstruktor verwenden.

Beispiele

String-Konstruktor und String-Funktion

Die String-Funktion und der String-Konstruktor erzeugen unterschiedliche Ergebnisse:

js
const a = new String("Hello world"); // a === "Hello world" is false
const b = String("Hello world"); // b === "Hello world" is true
a instanceof String; // is true
b instanceof String; // is false
typeof a; // "object"
typeof b; // "string"

Hier erzeugt die Funktion einen String (den primitiven 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.

js
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 string

js
const sym = Symbol("example");
String(sym); // "Symbol(example)"

Spezifikationen

Spezifikation

ECMAScript® 2027 Language Specification
# sec-string-constructor

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

Zahlen und Strings Leitfaden

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
String
Konstruktor
1. String()
Statische Methoden
Instanzmethoden
Instanzeigenschaften
1. length
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor