TypedArray.prototype.forEach()
forEach()
方法对类型化数组的每个元素调用提供的函数。这个方法的算法和Array.prototype.forEach()
相同。TypedArray是这里的类型化数组类型之一。
语法
typedarray.forEach(callback[, 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
函数;不像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