The reduceRight()
method of TypedArray instances applies a function against an accumulator and each value of the typed array (from right-to-left) to reduce it to a single value. This method has the same algorithm as Array.prototype.reduceRight.
Syntax
reduceRight(callbackFn)
reduceRight(callbackFn, initialValue)
Parameters
callbackFn
- : A function to execute for each element in the typed array. Its return value becomes the value of the
accumulator
parameter on the next invocation ofcallbackFn
. For the last invocation, the return value becomes the return value ofreduceRight()
. The function is called with the following arguments:accumulator
- : The value resulting from the previous call to
callbackFn
. On the first call, its value isinitialValue
if the latter is specified; otherwise its value is the last element of the typed array.
- : The value resulting from the previous call to
currentValue
- : The value of the current element. On the first call, its value is the last element if
initialValue
is specified; otherwise its value is the second-to-last element.
- : The value of the current element. On the first call, its value is the last element if
currentIndex
- : The index position of
currentValue
in the typed array. On the first call, its value isarray.length - 1
ifinitialValue
is specified, otherwisearray.length - 2
.
- : The index position of
array
- : The typed array
reduceRight()
was called upon.
- : The typed array
- : A function to execute for each element in the typed array. Its return value becomes the value of the
initialValue
- : Value to use as accumulator to the first call of the
callbackFn
. If no initial value is supplied, the last element in the typed array will be used and skipped. CallingreduceRight()
on an empty typed array without an initial value creates aTypeError
.
- : Value to use as accumulator to the first call of the
Return value
The value that results from the reduction.
Description
See Array.prototype.reduceRight for more details. This method is not generic and can only be called on typed array instances.
Examples
Sum up all values within an array
const total = new Uint8Array([0, 1, 2, 3]).reduceRight((a, b) => a + b);
// total === 6