Array.prototype.values()

The values() method returns a new Array Iterator object that contains the values for each index in the array.

var a = ['a', 'b', 'c', 'd', 'e']; 
var iterator = a.values();

console.log(iterator.next().value); // a
console.log(iterator.next().value); // b
console.log(iterator.next().value); // c
console.log(iterator.next().value); // d
console.log(iterator.next().value); // e

Syntax

arr.values()

Return value

A new Array iterator object.

Examples

Iteration using for...of loop

var arr = ['a', 'b', 'c', 'd', 'e'];
var iterator = arr.values();

for (let letter of iterator) {
  console.log(letter);
}

Array.prototype.values is default implementation of Array.prototype[Symbol.iterator].

Array.prototype.values === Array.prototype[Symbol.iterator]      //true

TODO: please write about why we need it, use cases.

Specifications

Browser compatibility

See also

• Array.prototype.keys()
• Array.prototype.entries()
• Array.prototype.forEach()
• Array.prototype.every()
• Array.prototype.some()