String.prototype.concat()

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

concat() 方法用於 String 值,將字串引數連線到該字串並返回一個新字串。

試一試

const str1 = "Hello";
const str2 = "World";

console.log(str1.concat(" ", str2));
// Expected output: "Hello World"

console.log(str2.concat(", ", str1));
// Expected output: "World, Hello"

語法

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

引數

str1, …, strN

要連線到 str 的一個或多個字串。雖然技術上允許,但使用零個引數呼叫 String.prototype.concat() 是無用的操作,因為它不會導致可觀察的複製(類似於 Array.prototype.concat()),因為字串是不可變的。它應該只會在你 展開 一個字串陣列作為引數,而該陣列恰好為空時發生。

返回值

包含所提供字串合併文字的新字串。

描述

concat() 函式將字串引數連線到呼叫字串並返回一個新字串。

如果引數不是字串型別,則在連線之前會將它們轉換為字串值。

concat() 方法非常類似於 加法/字串連線運算子+, +=),不同之處在於 concat()直接將引數強制轉換為字串,而加法運算子會先將運算元強制轉換為原始型別。有關更多資訊,請參閱 + 運算子 的參考頁面。

示例

使用 concat()

以下示例將字串合併成一個新字串。

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"

規範

規範
ECMAScript® 2026 語言規範
# sec-string.prototype.concat

瀏覽器相容性

另見