HOWTO · JavaScript

將陣列傳遞給 JavaScript 中的函式

了解何時將陣列作為單一引數傳遞、何時用 apply() 或展開語法將其元素展開為個別引數,以及如何透過 arguments 物件讀取接收到的值。

本頁內容

將陣列傳入 JavaScript 函式時,先確認函式應接收整個陣列作為一個值,還是將陣列元素分別作為位置引數。若函式只需要一個陣列參數,直接傳入陣列即可;若要分別傳入元素,可使用 apply() 或 spread 語法;在一般函式中,也可以從 arguments[0] 讀取傳入的陣列。這些方式適用於不同的函式簽章。

以下範例都是獨立的 JavaScript 程式碼片段。apply()、spread 和 arguments 範例會顯示其觀察到的輸出。

使用 apply() 將陣列元素作為函式引數傳入

Function.prototype.apply() 會以指定的 this 值呼叫函式,並將陣列或類陣列物件中的項目作為位置引數傳入。第一個參數是 this 值,第二個參數是引數清單。它不會傳回 arguments 物件;apply() 傳回的是函式本身的傳回值。當你需要指定 this,同時提供引數清單時,可以使用這種方式。

這個範例會將陣列中的每個元素傳給對應的參數。標籤取自指定的 this 值。

const names = ['Mehvish', 'John', 'Henry', 'Thomas'];

function displayName(first, second, third, fourth) {
  console.log(`${this.label}: ${first}, ${second}, ${third}, ${fourth}`);
}

displayName.apply({ label: 'Names' }, names);
Names: Mehvish, John, Henry, Thomas

如果函式預期只接收陣列作為一個參數,請宣告一個參數,並直接傳入 names。函式會將完整陣列作為單一值接收:

const names = ['Mehvish', 'John', 'Henry', 'Thomas'];

function displayName(names) {
  console.log(names.join(', '));
}

displayName(names);

這種函式簽章與上方有四個參數的 displayName 不同:直接傳入時,函式收到一個陣列引數;使用 apply() 時,陣列中的四個元素會成為四個獨立引數。spread 語法也會在呼叫函式時展開陣列元素。

使用 Spread 語法將陣列元素作為函式引數傳入

spread 語法(...)會在函式呼叫時,將陣列等可疊代物件展開為個別值。每個值會依序對應到位置參數。當函式需要分別接收引數,而你不需要透過 apply() 指定 this 值時,可以使用這種方式。

const names = ['Mehvish', 'John', 'Henry', 'Thomas'];

function displayName(first, second, third, fourth) {
  console.log(`${first}, ${second}, ${third}, ${fourth}`);
}

displayName(...names);
Mehvish, John, Henry, Thomas

在這裡,displayName 會收到四個字串引數。相較之下,displayName(names) 只會提供一個引數,而該引數的值是完整陣列。函式宣告的參數應與呼叫運算式相符,才能取得所需形式的資料。spread 運算式作用於呼叫端,因此函式可以保留一般的具名參數。

使用 arguments 物件讀取函式引數

一般函式內可以使用 arguments 物件,其中包含傳入該次呼叫的值。它具有類陣列特性,包含 length 屬性和可透過索引存取的項目,但它本身不是 Array,也不具備所有 Array 方法。箭頭函式不會建立自己的 arguments 物件,因此這種寫法應使用一般函式。

如果呼叫函式時只傳入一個陣列,該陣列會位於 arguments[0],而 arguments.length 的值為 1。接著,函式可以檢查或逐一處理該索引中的陣列。arguments 用來描述函式收到的值,並不是傳遞陣列的方式。

const names = ['Mehvish', 'John', 'Henry', 'Thomas'];

function inspectArguments() {
  console.log(arguments.length);
  console.log(arguments[0].join(', '));
}

inspectArguments(names);
1
Mehvish, John, Henry, Thomas

若要將類陣列的 arguments 集合複製成可使用陣列方法的陣列,請使用 Array.from(arguments)。對於輸入項目已知的現代函式,使用具名參數或 rest 參數通常更清楚。函式需要整個陣列作為集合時,請直接傳入陣列;需要將陣列項目作為個別參數時,則使用 apply() 或 spread 語法。