TypedArray.prototype.reduce()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2016.

reduce() 方法接受一个函数作为参数,这个函数作为一个累加器,从左到右遍历整个类型数组,最后返回一个单一的值。这个方法和Array.prototype.reduce()使用了同样的算法。TypedArray 是一个 类型数组.

语法

js
reduce(callbackFn)
reduce(callbackFn, initialValue)

参数

callback

对类型数组的每一个值应用的函数,它接受以下参数:

previousValue

在上一次迭代中,调用 callback 的返回值,或者是提供的 initialValue

currentValue

类型化数组中当前要处理的值。

index

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

array

reduce 在其上调用的类型化数组。

initialValue

可选。用作 callback 首次调用`的第一个参数的对象。

返回值

由归约返回的结果。

描述

reduce方法对类型化数组中出现的每个元素执行callback函数,除了类型化数组的空隙。它接受四个参数:初始值(或者来自之前callback调用的值),当前元素的值,当前下标,以及被遍历的类型化数组。

第一次调用回调函数的时候, previousValuecurrentValue 可以是两个值之一。如果 initialValuereduce的调用中提供, previousValue 会等于initialValue 并且currentValue 会等于类型化数组的第一个值。如果 initialValue 没有提供,则previousValue等于类型化数组的第一个值,currentValue会等于第二个值。

如果类型化数组为空并且没有提供 initialValue,会抛出 TypeError 。如果类型化数组中只有一个元素(无论位置)并且没有提供initialValue ,或者如果提供了initialValue 但是类型化数组为空,会返回唯一的值,但不会调用 callback

示例

累加数组中的所有值

js
var total = new Uint8Array([0, 1, 2, 3]).reduce(function (a, b) {
  return a + b;
});
// total == 6

规范

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.reduce

浏览器兼容性

BCD tables only load in the browser

参见