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 verkettet die Zeichenfolgenargumente mit dieser Zeichenfolge und gibt eine neue Zeichenfolge zurück.

Probieren Sie es aus

Syntax

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

Parameter

str1, …, strN

Eine oder mehrere Zeichenfolgen, die an str angehängt werden sollen. Obwohl technisch erlaubt, ist der Aufruf von String.prototype.concat() ohne Argumente eine sinnlose Operation, da keine beobachtbare Kopie entsteht (wie bei Array.prototype.concat()), da Zeichenfolgen unveränderlich sind. Dies sollte nur geschehen, wenn Sie ein Array von Zeichenfolgen als Argumente spreizen, und dieses Array zufällig leer ist.

Rückgabewert

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

Beschreibung

Die Funktion concat() verkettet die Zeichenfolgenargumente mit der aufrufenden Zeichenfolge und gibt eine neue Zeichenfolge zurück.

Wenn die Argumente nicht vom Typ Zeichenfolge sind, werden sie vor dem Verketten in Zeichenfolgenwerte umgewandelt.

Die concat()-Methode ist der Additions-/Zeichenfolgenverkettungsoperatoren (+, +=) sehr ähnlich, außer dass concat() seine Argumente direkt in Zeichenfolgen umwandelt, während die Addition ihre Operanden zuerst auf primitive Werte umsetzt. Weitere Informationen finden Sie auf der Referenzseite für den +-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 Language Specification
# sec-string.prototype.concat

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch