此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。
Array.prototype.join()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
join() 方法會將陣列（或一個類陣列（array-like）物件）中所有的元素連接、合併成一個字串，並回傳此字串。
嘗試一下
const elements = ["Fire", "Air", "Water"];console.log(elements.join());// Expected output: "Fire,Air,Water"console.log(elements.join(""));// Expected output: "FireAirWater"console.log(elements.join("-"));// Expected output: "Fire-Air-Water"語法
arr.join([separator])
參數
separator選擇性用來隔開陣列中每個元素的字串。如果必要的話，separator 會自動被轉成字串型態。如果未傳入此參數，陣列中的元素將預設用英文逗號（「,」）隔開。如果
separator是空字串，合併後，元素間不會有任何字元。
回傳值
一個合併所有陣列元素的字串。假如arr.length 為0，將回傳空字串。
描述
將所有陣列中的元素轉成字串型態後，連接合併成一個字串。任何undefined 或null 的元素都會被視為空字串處理。
範例
舉例四種合併用法
下方的範例中，首先宣告一個陣列—a，其中有三個元素。接著分別用：預設值、逗號、加號和空字串將陣列連接。
js
var a = ["Wind", "Rain", "Fire"];a.join(); // 'Wind,Rain,Fire'a.join(", "); // 'Wind, Rain, Fire'a.join(" + "); // 'Wind + Rain + Fire'a.join(""); // 'WindRainFire'合併一個類陣列（array-like）物件
下方的範例將合併一個類陣列（array-like）物件（arguments），藉由Function.prototype.call 來呼叫Array.prototype.join。
js
function f(a, b, c) { var s = Array.prototype.join.call(arguments); console.log(s); // '1,a,true'}f(1, "a", true);//expected output: "1,a,true"規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.join |