forEach() 方法对类型化数组的每个元素调用提供的函数。这个方法的算法和Array.prototype.forEach() 相同。TypedArray 是这里的类型化数组类型之一。

语法

forEach(callbackFn)forEach(callbackFn, thisArg)

参数

callback

产生新的类型化数组的元素的函数，接受三个函数：

currentValue

类型化数组中要处理的当前元素

index

类型化数组中要处理的当前元素的下标

array

forEach()在其上调用的类型化数组

thisArg

可选，执行callback时作为this的值。

返回值

undefined.

描述

forEach方法对类型化数组中的元素按升序调用提供的callback函数。它不会对删除或者省略的下标调用，但是会对存在并且值为undefined的元素调用。

callback 以三个参数调用：

• the元素的值
• the元素下标
• the被遍历的类型化数组

如果将thisArg 参数提供给forEach，它会在调用时传递给callback，作为它的this 值。否则，会传递undefined 作为它的this 值。callback最终观测到的this 值由用于决定函数可见的this 值的一般规则来决定。

由forEach处理的元素范围在callback调用之前就确定了。在forEach调用之后添加到数组的元素不会由callback访问。如果类型化数组的现有元素被改变，或被删除，它们传给callback的值是forEach 访问它们时候的值。已删除的元素不会被访问。

forEach()对每个数组元素执行一次callback 函数；不像every() 和some()，它始终返回undefined。

示例

记录类型化数组的内容

下面的代码为数组中的每个元素记录一行日志：

function logArrayElements(element, index, array) {  console.log("a[" + index + "] = " + element);}new Uint8Array([0, 1, 2, 3]).forEach(logArrayElements);// 日志：// a[0] = 0// a[1] = 1// a[2] = 2// a[3] = 3

规范

浏览器兼容性

参见

• TypedArray.prototype.map()
• TypedArray.prototype.every()
• TypedArray.prototype.some()
• Array.prototype.forEach()