此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

TypedArray.prototype.reduceRight()

基线 广泛可用

自 2016年9月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

reduceRight() 在累加器和类型化数组的每个元素上(从右到左)调用函数,使其归约为单一的值。这个方法的算法和 Array.prototype.reduceRight() 相同。TypedArray 是这里的类型化数组类型之一。

语法

js
reduceRight(callbackFn)
reduceRight(callbackFn, initialValue)

参数

callback

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

previousValue

回调函数上一次调用所返回的值,或者是提供的 initialValue

currentValue

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

index

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

array

reduceRight 在其上调用的类型化数组

initialValue

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

返回值

由归约返回的结果。

描述

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

reduceRight回调函数的调用是这样:

js
typedarray.reduceRight(
  function (previousValue, currentValue, index, typedarray) {
    // ...
  },
);

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

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

示例

累加数组中的所有值

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

规范

规范
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.reduceright

浏览器兼容性

参见