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

BCD tables only load in the browser

Siehe auch