JavaScript - TypedArray reduce() 方法



JavaScript TypedArray reduce() 方法在类型化数组的每个元素上执行用户提供的 “reducer” 回调函数。它返回一个值,作为对整个类型化数组执行回调函数获得的结果。

它接受一个名为 'initialValue' 的可选参数。如果我们不把这个参数传给方法,它会把 arr[0] 值当作初始值。此外,它将对传递的 initialValue 参数执行回调函数。

注意 − 如果当前 TypedArray 为空或不包含任何初始值,则此方法将引发 'TypeError' 异常。

语法

以下是 JavaScript TypedArray reduce() 方法的语法 -


 reduce(callbackFn, initialValue)

参数

此方法接受两个名为 'callbackFn' 和 'initialValue' 的参数,如下所述 -

  • callbackFn − 用户提供的函数,用于对类型化数组的每个元素执行。这个 callbackFn 函数也接受四个参数,分别是 'accumulator'、'currentValue'、'currentIndex' 和 'array'。以下是每个参数的说明:
    • accumulator − 此参数表示先前迭代产生的累积值。它从初始值(显式提供或数组的第一个元素)开始,并在每次迭代时更新。
    • currentValue − 类型化数组中当前元素的值。如果指定了 initialValue,则其值将为 arr[0],否则其值将为 arr[1]。
    • currentIndex − 类型化数组中 currentValue 的索引位置。
    • array − 调用 reduce() 方法的类型化数组。
  • initialValue - 首次调用回调函数时 accumulator 参数初始化为的值。

返回值

此方法返回一个值,该值是通过执行 “reducer” 回调函数来完成整个类型化数组的。

示例 1

类型化数组中所有元素的乘积。

在下面的示例中,我们使用 JavaScript TypedArray reduce() 方法在此类型化数组 [1, 2, 3, 4, 5] 的每个元素上执行用户提供的名为 multi() 的函数。multi() 函数将当前类型化数组中的所有元素相乘。


<html>
<head>
   <title>JavaScript TypedArray reduce() Method</title>
</head>
<body>
   <script>
      //function
      function multi(accumulator, currentValue){
         return accumulator * currentValue;
      }
      const T_array = new Uint16Array([1, 2, 3, 4, 5]);
      document.write("Typed array: ", T_array);
      
      //using the reduce() method
      document.write("<br>The product of typed array elements: ", T_array.reduce(multi));
   </script>    
</body>
</html>

 输出

上面的程序返回类型化数组元素的乘积为 120。

Typed array: 1,2,3,4,5
The product of typed array elements: 120

示例 2

如果我们将 initialValue 参数传递给此方法,则 reduce() 方法还会对其执行用户提供的回调函数,并返回单个值作为结果。

在下面的示例中,我们使用 JavaScript TypedArray reduce() 方法对类型化数组 [10, 20, 30, 40, 50] 的每个元素执行用户提供的名为 sum() 的回调函数,包括传递的 initialValue 参数值 10。sum() 函数累积当前类型化数组中所有元素的总和。


<html>
<head>
   <title>JavaScript TypedArray reduce() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint16Array([10, 20, 30, 40, 50]);
      document.write("Typed array: ", T_array);
      const initialValue = 10;
      document.write("<br>Initial value: ", initialValue);
      
      let sum = T_array.reduce(function(accumulator, currentValue){
         return accumulator + currentValue;
      }, initialValue);
      document.write("<br>The sum of typed array elements(including initial value): ", sum);
   </script>    
</body>
</html>

输出

执行上述程序后,它将返回类型化数组中所有元素的总和,包括初始值 -

Typed array: 10,20,30,40,50
Initial value: 10
The sum of typed array elements(including initial value): 160

示例 3

如果当前类型化数组不包含任何元素(没有可用的初始值),reduce() 方法将抛出 “TypeError” 异常。

在下面给定的示例中,我们使用 JavaScript TypedArray reduce() 方法在这个空类型化数组 ([]) 的每个元素上执行用户提供的名为 “ArrowFunction” 的 reducer 回调函数。


<html>
<head>
   <title>JavaScript TypedArray reduce() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint16Array([]);//empty typed array
      document.write("Length of the typed array: ", T_array.length);
      
      //using the reduce method
      try {
         T_array.reduce((a, b)=> a + b);
      } catch (error) {
         document.write("<br>", error);
      }
   </script>    
</body>
</html>

输出

一旦执行了上述程序,它将抛出 'TypeError' 异常。

Length of the typed array: 0
TypeError: Reduce of empty array with no initial value