--- title: Array.prototype.values() slug: Web/JavaScript/Reference/Global_Objects/Array/values translation_of: Web/JavaScript/Reference/Global_Objects/Array/values ---
{{JSRef}}

 

Il metodo values() restituisce un nuovo oggetto Array Iterator che contiene i valori per ogni indice nell'array.

{{EmbedInteractiveExample("pages/js/array-values.html")}}

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

Sintassi

arr.values()

Valore di ritorno

Un nuovo oggetto iteratore {{jsxref("Array")}}.

Esempi

Iterazione utilizzando il  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 è una implementazionde di default di Array.prototype[Symbol.iterator].

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

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

Specificazioni

Specification Status Comment
{{SpecName('ES2015', '#sec-array.prototype.values', 'Array.prototype.values')}} {{Spec2('ES2015')}} Definizione iniziale.
{{SpecName('ESDraft', '#sec-array.prototype.values', 'Array.prototype.values')}} {{Spec2('ESDraft')}}  

Browser compatibility

{{Compat("javascript.builtins.Array.values")}}

See also