Array.prototype.concat()

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.

concat() 方法被用來合併兩個或多個陣列。此方法不會改變現有的陣列，回傳一個包含呼叫者陣列本身的值，作為代替的是回傳一個新陣列。

嘗試一下

語法

var new_array = old_array.concat(value1[, value2[, ...[, valueN]]])

參數

valueN

陣列以及／或者值，用來合併成一個新的陣列。請參閱下方詳細資訊描述。

回傳值

一個新的陣列實體。

描述

concat 產生一個由呼叫者陣列自己的元素，以及對每一個參數按照順序，合併參數的元素（如果參數是個陣列）或者是參數自己本身（如果參數不是一個陣列）成為一個新的陣列。concat 方法不會遞迴巢狀陣列參數。

concat 方法不會改變 this 自己本身或是任何被提供當做參數的陣列，取而代之則是回傳一個淺層複製（shallow copy）包含了與原始的陣列中一樣的元素的副本。原始陣列的元素被複製到新的陣列的規則如下所示：

  • 物件參考（並非為實際的物件）：concat 複製物件的參考至新的陣列。不管是原始的還是新的陣列都參考到相同的物件。也就是說，如果一個被參照的物件被修改了，變動會同時反映到新的以及原始的陣列中。
  • 資料型態為字串、數值或是布林（非 String、Number 及 Boolean 物件）：concat 複製字串及數值的值到新的陣列。

備註： 合併（多個）陣列／（多個）值將讓原始的陣列不會被受到影響。此外，任何對新陣列（只有在元素不是物件參考的情況下）的操作都不會影響原始的陣列，反之亦然。

範例

合併兩個陣列

下面的程式碼為合併兩個陣列：

js
var alpha = ["a", "b", "c"];
var numeric = [1, 2, 3];

alpha.concat(numeric);
// 結果: ['a', 'b', 'c', 1, 2, 3]

合併三個陣列

下面的程式碼為合併三個陣列：

js
var num1 = [1, 2, 3],
  num2 = [4, 5, 6],
  num3 = [7, 8, 9];

var nums = num1.concat(num2, num3);

console.log(nums);
// 結果：[1, 2, 3, 4, 5, 6, 7, 8, 9]

合併值到一個陣列

下面的程式碼為合併三個值到一個陣列中：

js
var alpha = ["a", "b", "c"];

var alphaNumeric = alpha.concat(1, [2, 3]);

console.log(alphaNumeric);
// 結果：['a', 'b', 'c', 1, 2, 3]

合併巢狀陣列

下面的程式碼為合併巢狀陣列，並證明保留了原本的參考（references）：

js
var num1 = [[1]];
var num2 = [2, [3]];

var nums = num1.concat(num2);

console.log(nums);
// results in [[1], 2, [3]]

// modify the first element of num1
num1[0].push(4);

console.log(nums);
// results in [[1, 4], 2, [3]]

規格

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

瀏覽器相容性

BCD tables only load in the browser

參見