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 July 2015.

join() 方法會將陣列（或一個類陣列（array-like）物件）中所有的元素連接、合併成一個字串，並回傳此字串。

嘗試一下

語法

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 Language Specification
# sec-array.prototype.join

瀏覽器相容性

BCD tables only load in the browser

參見