Array.prototype.join()

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

語法

arr.join([separator])

參數

separator 選擇性
用來隔開陣列中每個元素的字串。如果必要的話,separator 會自動被轉成字串型態。如果未傳入此參數,陣列中的元素將預設用英文逗號(「,」)隔開。如果 separator 是空字串,合併後,元素間不會有任何字元。

回傳值

一個合併所有陣列元素的字串。假如 arr.length0,將回傳空字串。

描述

將所有陣列中的元素轉成字串型態後,連接合併成一個字串。任何 undefinednull 的元素都會被視為空字串處理。

範例

舉例四種合併用法

下方的範例中,首先宣告一個陣列—a,其中有三個元素。接著分別用:預設值、逗號、加號和空字串將陣列連接。

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

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"

規範

規範 狀態 註解
ECMAScript 1st Edition (ECMA-262) Standard Initial definition. Implemented in JavaScript 1.1.
ECMAScript 5.1 (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Standard  
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Standard  
ECMAScript (ECMA-262)
The definition of 'Array.prototype.join' in that specification.
Living Standard  

瀏覽器相容性

BCD tables only load in the browser

參見