• JavaScript Video Tutorials

JavaScript - TypedArray values() Method

The JavaScript TypedArray values() method returns an array iterator object that iterates over the values of each element in the typed array. This particular method is not applicable to all arrays and can only be invoked on instances of typed arrays.

Syntax

Following is the syntax of JavaScript TypedArray values() method −

values()

Parameters

  • It does not accept any parameters.

Return value

This method returns a new array iterable object.

Examples

Example 1

The following program demonstrates the usage of the JavaScript TypedArray values() method.

<html>
<head>
   <title>JavaScript TypedArray values() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint8Array([1, 2, 3, 4, 5]);
      document.write("The original typed array: ", T_array);
      
      //using the values() method
      let new_array = T_array.values();
      document.write("<br>The new_array iterator object: ", new_array);
   </script>    
</body>
</html>

Output

The above program returns a new "object Array iterator".

The original typed array: 1,2,3,4,5
The new_array iterator object: [object Array Iterator]

Example 2

The following is another example of the JavaScript TypedArray values() method. Using this method, we are trying to retrieve a new object array iterator from this typed array [10, 20, 30, 40, 50]. We use the next().value on the object array iterator to retrieve a specific element.

<html>
<head>
   <title>JavaScript TypedArray values() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint8Array([10, 20, 30, 40, 50]);
      document.write("The original typed array: ", T_array);
      
      //using the values() method
      let new_array = T_array.values();
      document.write("<br>The new_array iterator object: ", new_array);
      document.write("<br>The new_array.next().value returns: ", new_array.next().value);
      
      //expected output 10.
   </script>    
</body>
</html>

Output

After executing the above program, it returns the following output −

The original typed array: 10,20,30,40,50
The new_array iterator object: [object Array Iterator]
The new_array.next().value returns: 10

Example 3

In this example, we use the for...of loop to iterate through each element of the object array iterator returned by the values() method.

<html>
<head>
   <title>JavaScript TypedArray values() Method</title>
</head>
<body>
   <script>
      const T_array = new Uint8Array([10, 20, 30, 40, 50]);
      document.write("The original typed array: ", T_array);
      
      //using the values() method
      let new_array = T_array.values();
      document.write("<br>The object array iterator values: ");
      
      //using for...of loop
      for(const i of new_array){
         document.write(i, " ");
      }
   </script>    
</body>
</html>

Output

Once the above program is executed, it returns each element of the object array iterator as −

The original typed array: 10,20,30,40,50
The object array iterator values: 10 20 30 40 50
Advertisements