The values() method returns a new Array Iterator object that contains the values for each index in the array.
var a = ['w', 'y', 'k', 'o', 'p']; var iterator = a.values(); console.log(iterator.next().value); // w console.log(iterator.next().value); // y console.log(iterator.next().value); // k console.log(iterator.next().value); // o console.log(iterator.next().value); // p
Syntax
arr.values()
Return value
A new Array iterator object.
Examples
Iteration using for...of loop
var arr = ['w', 'y', 'k', 'o', 'p'];
var iterator = arr.values();
for (let letter of iterator) {
console.log(letter);
}
Specifications
| Specification | Status | Comment |
|---|---|---|
| ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Array.prototype.values' in that specification. |
Standard | Initial definition. |
| ECMAScript Latest Draft (ECMA-262) The definition of 'Array.prototype.values' in that specification. |
Draft |
Browser compatibility
| Feature | Chrome | Edge | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | No support [1] | (Yes) | Nightly build [2] | No support | No support | 9 |
| Feature | Android | Chrome for Android | Edge | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|---|---|
| Basic support | No support | No support [1] | (Yes) | No support | No support | No support | No support |
[1] See bug 615873 (compatibilty issues).
[2] See bug 1299593 which disables Array.prototype.values outside of Firefox Nightly due to compatibility issues.
See also
Document Tags and Contributors
Tags:
Contributors to this page:
concavelenz,
erikadoyle,
kdex,
David_Gilbertson,
fscholz,
eduardoboucas,
malyw,
yihongang,
riyajk,
coin723,
yan,
arai,
Mingun,
P0lip
Last updated by:
concavelenz,