Signatur
concat(str1)
concat(str1, str2)
concat(str1, str2, /* …, */ strN)
Beschreibung
Die Methode concat() von String-Werten verkettet die String-Argumente mit diesem String und gibt einen neuen String zurück.
Die Funktion concat() verkettet die String-Argumente mit dem aufrufenden String und gibt einen neuen String zurück.
Wenn die Argumente nicht vom Typ String sind, werden sie vor der Verkettung in String-Werte umgewandelt.
Die Methode concat() ist den Additions-/String-Konkatenations-Operatoren (+, +=) sehr ähnlich, mit dem Unterschied, dass concat() ihre Argumente direkt zu Strings umwandelt, während die Addition ihre Operanden zunächst zu Primitiven umwandelt. Weitere Informationen finden Sie auf der Referenzseite zum +-Operator.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $str1, …, strN | string | — | Ein oder mehrere Strings, die mit str verkettet werden sollen. Obwohl technisch erlaubt, ist der Aufruf von String.prototype.concat() ohne Argumente eine nutzlose Operation, da er im Gegensatz zu Array.prototype.concat() zu keinem beobachtbaren Kopieren führt, weil Strings unveränderlich sind. Dies sollte nur vorkommen, wenn Sie ein Array von Strings als Argumente per spread übergeben und dieses Array zufällig leer ist. |
Rückgabewert
Typ
string
Beschreibung
Ein neuer String, der den kombinierten Text der übergebenen Strings enthält.
Beispiele
Verwendung von concat()
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"