String.prototype[@@iterator]()

La méthode [@@iterator]() renvoie un nouvel objet Iterator qui itère sur les points de code (codets) d'une chaîne de caractères, en renvoyant chaque point de code sous forme d'une chaîne de caractères.

Syntaxe

chaîneDeCaractères[Symbol.iterator]

Valeur de retour

Un nouvel objet Iterator.

Exemples

Utiliser [@@iterator]()

var chaîne = "A\uD835\uDC68";

var chaîneIter = chaîne[Symbol.iterator]();

console.log(chaîneIter.next().value); // "A"
console.log(chaîneIter.next().value); // "\uD835\uDC68"

Utiliser [@@iterator]() avec une boucle for..of

var chaine = "A\uD835\uDC68B\uD835\uDC69C\uD835\uDC6A";

for (var c of chaine) {
  console.log(c);
}
// "A"
// "\uD835\uDC68"
// "B"
// "\uD835\uDC69"
// "C"
// "\uD835\uDC6A"

Spécifications

Compatibilité des navigateurs

[1] Dans les versions comprises entre Gecko 17 (Firefox 17 / Thunderbird 17 / SeaMonkey 2.14) et Gecko 26 (Firefox 26 / Thunderbird 26 / SeaMonkey 2.23 / Firefox OS 1.2) la propriété iterator était utilisée à cet effet (bug 907077). Dans les versions allant de Gecko 27 (Firefox 27 / Thunderbird 27 / SeaMonkey 2.24) à Gecko 35 (Firefox 35 / Thunderbird 35 / SeaMonkey 2.32) la chaîne de caractères "@@iterator" était utilisée en tant que substitut en attendant l'implémentation du Symbol @@iterator (bug 918828).

Voir aussi

• Les protocoles d'itération