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 数组迭代