JavaScript - TypedArray reduce() 方法

JavaScript TypedArray 的reduce() 方法会对用户提供的“reducer”回调函数在TypedArray的每个元素上执行。它返回一个单个值，该值是通过在整个TypedArray上执行回调函数获得的结果。

它接受一个名为'initialValue' 的可选参数。如果我们不向方法传递此参数，它将考虑arr[0] 值作为初始值。此外，它还将在传递的 initialValue 参数上执行回调函数。

注意 - 如果当前的TypedArray为空或不包含任何初始值，此方法将抛出'TypeError' 异常。

语法

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

reduce(callbackFn, initialValue)

参数

此方法接受两个名为“callbackFn”和“initialValue”的参数，如下所述：

callbackFn - 用户提供的函数，在TypedArray的每个元素上执行。

此 callbackFn 函数还接受四个参数，即 'accumulator'、'currentValue'、'currentIndex' 和 'array'。以下是每个参数的说明

accumulator - 此参数表示先前迭代产生的累积值。它从初始值（显式提供或数组的第一个元素）开始，并在每次迭代时更新。
currentValue - TypedArray中当前元素的值。如果指定了initialValue，其值为arr[0]，否则其值为arr[1]。
currentIndex - currentValue在TypedArray中的索引位置。
array - 调用reduce()方法的TypedArray。

initialValue - 第一次调用回调函数时，accumulator参数初始化的值。

返回值

此方法返回一个单个值，该值是通过在整个TypedArray上执行“reducer”回调函数到完成而产生的结果。

示例

示例 1

TypedArray中所有元素的乘积。

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

<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>

输出

上述程序返回TypedArray元素的乘积为 120。

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

示例 2

如果我们向此方法传递initialValue 参数，reduce() 方法也会在它上面执行用户提供的回调函数，并返回单个值作为结果。

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

<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>

输出

执行上述程序后，它将返回TypedArray中所有元素的总和，包括初始值：

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

示例 3

如果当前TypedArray不包含任何元素（没有可用的初始值），reduce() 方法将抛出“TypeError” 异常。

在下面的示例中，我们使用 JavaScript TypedArray reduce() 方法在这个空TypedArray ([]) 的每个元素上执行名为“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

打印页面