CKTIS / JavaScript
String.prototype.concat — Zeichenfolgen verbinden
String.prototype.concat hängt beliebig viele Argumente an eine Zeichenfolge an und wandelt sie dabei in Text um. Die Methode gibt einen primitiven String-Wert zurück und verändert die ursprüngliche Zeichenfolge nicht.
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
str.concat(...args)String.prototype.concat verbindet die Zeichenfolge des Empfängers mit null oder mehr Argumenten in der angegebenen Reihenfolge. Es werden keine Trennzeichen eingefügt: Leerzeichen und Satzzeichen müssen ausdrücklich angegeben werden. Das Ergebnis ist ein primitiver string-Wert und kein String-Objekt.
Zeichenfolgen sind unveränderlich: Die Methode verändert den ursprünglichen Wert nicht. Weise das Ergebnis einer Variablen zu, um es zu behalten. Ein Aufruf ohne Argumente gibt den Text des Empfängers unverändert zurück.
Der Empfänger wird zuerst in Text umgewandelt, danach folgen die Argumente von links nach rechts; verwendet wird ToString. Die Argumente null und undefined ergeben "null" beziehungsweise "undefined"; ein Argument vom Typ symbol löst einen TypeError aus. Bei der Umwandlung von Objekten kann benutzerdefinierter Code ausgeführt werden und eine Ausnahme auslösen.
Die Methode ist generisch: String.prototype.concat.call(42, "!") gibt "42!" zurück. Als Empfänger führen null und undefined jedoch zu einem TypeError. Dies ist eine Methode des ECMAScript-Standards und keine Browser-API.
Beispiele
const base = "Level";
const result = base.concat(" ", 3, "!");
console.log(result);
console.log(base);
console.log(base.concat() === base);Ergebnis
Level 3! Level 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.