Array.prototype[@@iterator]()

La valeur initiale de la propriété @@iterator correspond au même objet fonction que la valeur initiale de la propriété values.

Syntaxe

arr[Symbol.iterator]()

Valeur de retour

La fonction d'itération sur le tableau, par défaut, c'est la fonction values().

Exemples

Parcourir un tableau avec une boucle for...of

var arr = ['w', 'y', 'k', 'o', 'p'];
var eArr  = arr[Symbol.iterator]();
// il est nécessaire que l'environnement supporte
// les boucles for..of et les variables 
// utilisées avec let
for (let letter of eArr) {
  console.log(letter);
}

Parcourir un tableau avec next

var arr = ['w', 'y', 'k', 'o', 'p'];
var eArr = arr[Symbol.iterator]();
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

Compatibilité des navigateurs

[1]À partir de Gecko 17 (Firefox 17 / Thunderbird 17 / SeaMonkey 2.14) et jusqu'à Gecko 26 (Firefox 26 / Thunderbird 26 / SeaMonkey 2.23 / Firefox OS 1.2) la propriété iterator était utilisée (bug 907077), à partir de Gecko 27 et jusqu'à Gecko 35 (Firefox 35 / Thunderbird 35 / SeaMonkey 2.32) le paramètre fictif @@iterator fut utilisé à la place du symbole @@iterator (bug 918828).

Voir aussi

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