Array.prototype.values()

La méthode values() renvoie un nouvel objet Array Iterator qui contient les valeurs pour chaque indice du tableau. Cette méthode est l'implémentation par défaut de Array.prototype[Symbol.Iterator].

Exemple interactif

js
var a = ["t", "i", "t", "o", "u"];
var iterateur = a.values();

console.log(iterateur.next().value); // t
console.log(iterateur.next().value); // i
console.log(iterateur.next().value); // t
console.log(iterateur.next().value); // o
console.log(iterateur.next().value); // u

Syntaxe

js
array.values();

Valeur de retour

Un nouvel objet itérateur sur Array.

Exemples

Itérer avec une boucle for...of

js
var arr = ["w", "y", "k", "o", "p"];
var eArr = arr.values();
// votre navigateur doit supporter les boucles for..of
// et les variables définies avec let
for (let lettre of eArr) {
  console.log(lettre);
}

Itérer avec next()

js
var arr = ["w", "y", "k", "o", "p"];
var eArr = arr.values();
console.log(eArr.next().value); // w
console.log(eArr.next().value); // y
console.log(eArr.next().value); // k
console.log(eArr.next().value); // o
console.log(eArr.next().value); // p

Spécifications

Specification
ECMAScript Language Specification
# sec-array.prototype.values

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi