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

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 an str angehängt werden sollen. Obwohl technisch erlaubt, ist das Aufrufen von String.prototype.concat() ohne Argumente eine unnötige Operation, da es nicht zu einem beobachtbaren Kopieren führt (wie bei Array.prototype.concat()), da Zeichenfolgen unveränderlich sind. Dies sollte nur geschehen, wenn Sie ein Array von Zeichenfolgen als Argumente spreading und dieses Array zufällig leer ist.

Rückgabewert

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

Beschreibung

Die concat()-Funktion 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 Verkettungsprozess in Zeichenfolgen umgewandelt.

Die concat()-Methode ist der Verwendung der Addition/Zeichenfolgenverkettungsoperatoren (+, +=) sehr ähnlich, außer dass concat() ihre Argumente direkt in Zeichenfolgen umwandelt, während die Addition ihre Operanden zuerst in primitive Werte umwandelt. 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® 2025 Language Specification
# sec-string.prototype.concat

Browser-Kompatibilität

Siehe auch