JavaScript Array forEach()

定義和用法

forEach() 方法按順序為數組中的每個元素調用一次函數。

注釋：對于沒有值的數組元素，不執行forEach() 方法。

實例

例子 1

列出數組中的每一項：

var fruits = ["apple", "orange", "cherry"];
fruits.forEach(myFunction);
function myFunction(item, index) {
  document.getElementById("demo").innerHTML += index + ":" + item + "<br>"; 
}

親自試一試

例子 2

獲取數組中所有值的總和：

var sum = 0;
var numbers = [65, 44, 12, 4];
numbers.forEach(myFunction);
function myFunction(item) {
  sum += item;
  document.getElementById("demo").innerHTML = sum;
}

親自試一試

例子 3

對于數組中的每個元素：將值更新為原始值的 10 倍：

var numbers = [65, 44, 12, 4];
numbers.forEach(myFunction)
function myFunction(item, index, arr) {
  arr[index] = item * 10;
}

親自試一試

語法

array.forEach(function(currentValue, index, arr), thisValue)

參數值

參數 描述
function(currentValue, index, arr) 必需。為數組中的每個元素運行的函數。

函數參數：

參數 描述
currentValue 必需。當前元素的值。
index 可選。當前元素的數組索引。
arr 可選。當前元素所屬的數組對象
thisValue

可選。要傳遞給函數以用作其 "this" 值的值。

如果此參數為空，則值 "undefined" 將作為其 "this" 值傳遞。

技術細節

返回值： undefined
JavaScript 版本： ECMAScript 5

瀏覽器支持

所有瀏覽器都完全支持 forEach() 方法：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9.0 支持 支持 支持 支持

相關頁面

教程：JavaScript 數組

教程：JavaScript 數組 Const

教程：JavaScript 數組方法

教程：JavaScript 排序數組

教程：JavaScript 數組迭代