String.prototype.concat()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die concat()-Methode von String-Werten verknüpft die übergebenen Zeichenfolgen mit der bestehenden Zeichenfolge und gibt eine neue Zeichenfolge zurück.

Probieren Sie es aus

const str1 = "Hello";
const str2 = "World";

console.log(str1.concat(" ", str2));
// Expected output: "Hello World"

console.log(str2.concat(", ", str1));
// Expected output: "World, Hello"

Syntax

js
concat(str1)
concat(str1, str2)
concat(str1, str2, /* …, */ strN)

Parameter

str1, …, strN

Eine oder mehrere Zeichenfolgen, die mit str verknüpft werden sollen. Obwohl technisch erlaubt, ist ein Aufruf von String.prototype.concat() ohne Argumente eine sinnlose Operation, da er nicht zu einer beobachtbaren Kopie führt (wie Array.prototype.concat()), da Zeichenfolgen unveränderlich sind. Dies sollte nur geschehen, wenn Sie ein Array mit Zeichenfolgen aufspalten und dieses Array zufällig leer ist.

Rückgabewert

Eine neue Zeichenfolge, die den kombinierten Text der bereitgestellten Zeichenfolgen enthält.

Beschreibung

Die Funktion concat() verknüpft die übergebenen Zeichenfolgen mit der aufrufenden Zeichenfolge und gibt eine neue Zeichenfolge zurück.

Wenn die Argumente nicht vom Typ string sind, werden sie vor dem Verknüpfen in Zeichenfolgen konvertiert.

Die Methode concat() ähnelt stark den Additions-/Zeichenfolgenverkettungsoperatoren (+, +=), außer dass concat() seine Argumente direkt in Zeichenfolgen umwandelt, während Addition die Operanden zuerst in primitive Werte umwandelt. Weitere Informationen finden Sie auf der Referenzseite zum + Operator.

Beispiele

Verwendung von concat()

Das folgende Beispiel kombiniert Zeichenfolgen zu einer neuen Zeichenfolge.

js
const hello = "Hello, ";
console.log(hello.concat("Kevin", ". Have a nice day."));
// Hello, Kevin. Have a nice day.

const greetList = ["Hello", " ", "Venkat", "!"];
"".concat(...greetList); // "Hello Venkat!"

"".concat({}); // "[object Object]"
"".concat([]); // ""
"".concat(null); // "null"
"".concat(true); // "true"
"".concat(4, 5); // "45"

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-string.prototype.concat

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
concat

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch