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