String.prototype.concat()

The concat() method of String values concatenates the string arguments to this string and returns a new string.

Try it

Syntax

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

Parameters

str1, …, strN

One or more strings to concatenate to str.

Return value

A new string containing the combined text of the strings provided.

Description

The concat() function concatenates the string arguments to the calling string and returns a new string.

If the arguments are not of the type string, they are converted to string values before concatenating.

The concat() method is very similar to the addition/string concatenation operators (+, +=), except that concat() coerces its arguments directly to strings, while addition coerces its operands to primitives first. For more information, see the reference page for the + operator.

Examples

Using concat()

The following example combines strings into a new string.

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"

Specifications

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

Browser compatibility

BCD tables only load in the browser

See also