Méthode JavaScript Array [Symbol.iterator]()

Array 对象参考手册Objet Array JavaScript


Exemple

Obtenez l'objet itérateur d'un tableau et affichez-le dans une boucle :

const fruits = ['apple', 'banana', 'orange']; //1. Obtenir l'objet itérateur du tableau const iterator = fruits[Symbol.iterator](); //2. Appeler manuellement la méthode next() de l'itérateur console.log(iterator.next()); // { value: 'apple', done: false } console.log(iterator.next()); // { value: 'banana', done: false } console.log(iterator.next()); // { value: 'orange', done: false } console.log(iterator.next()); // { value: undefined, done: true } //3. Utiliser la boucle for...of (elle appelle automatiquement [Symbol.iterator]() en interne) for (const fruit of fruits) { console.log(fruit); } //Sortie : // apple // banana // orange //4. Utiliser l'opérateur de propagation (repose également sur l'itérateur) const fruitCopy = [...fruits]; console.log(fruitCopy); // ['apple', 'banana', 'orange']

Essayez-le vous-même »

Définition et utilisation

[Symbol.iterator]()C'est une méthode intégrée des tableaux JavaScript, qui renvoie l'itérateur par défaut du tableau. Cette méthode fait du tableau un objet itérable, qui peut êtrefor...ofutilisé par les boucles et d'autres constructions.

Qu'est-ce qu'un itérateur ?

Avant d'expliquer[Symbol.iterator]()la méthode, nous devons d'abord comprendre ce qu'est un itérateur.

Un itérateur est un protocole en JavaScript qui définit comment accéder séquentiellement aux éléments d'une collection. Tout objet qui implémente le protocole d'itérateur peut être utilisé parfor...ofles boucles, l'opérateur de décomposition (...) et d'autres fonctionnalités JavaScript.

Un objet itérateur doit implémenter unenext()méthode, qui renvoie un objet contenant deux propriétés :

  • value: la valeur de l'itération en cours
  • done: un booléen indiquant si l'itération est terminée

Syntaxe de base

const iterator = array[Symbol.iterator]();

Exemple de code

Prenons un exemple simple :

Exemple

const fruits = ['apple', 'banana', 'orange'];

// Obtenir l'itérateur du tableau
const iterator = fruits[Symbol.iterator]();

console.log(iterator.next()); // { value: 'apple', done: false }
console.log(iterator.next()); // { value: 'banana', done: false }
console.log(iterator.next()); // { value: 'orange', done: false }
console.log(iterator.next()); // { value: undefined, done: true }

Dans cet exemple, nous :

  1. a créé un tableau contenant trois fruits
  2. via[Symbol.iterator]()méthode, a obtenu l'itérateur du tableau
  3. Appelez à plusieurs reprises la méthode de l'itérateurnext()méthode pour obtenir chaque élément du tableau à tour de rôle.

Scénarios d'application pratiques

1. Utilisation de la boucle for...of

for...ofLa boucle appelle automatiquement en interne l'itérateur du tableau[Symbol.iterator]()méthode :

Exemple

const colors = ['red', 'green', 'blue'];

for (const color of colors) {
  console.log(color);
}
// Sortie :
// red
// green
// blue

2. Utilisation de l'opérateur de décomposition

L'opérateur de décomposition repose également sur le protocole d'itérateur :

Exemple

const numbers = [1, 2, 3];
const copiedNumbers = [...numbers];

console.log(copiedNumbers); // [1, 2, 3]

3. Affectation par déstructuration

La déstructuration de tableau utilise aussi l'itérateur :

Exemple

const [first, second] = ['a', 'b', 'c'];
console.log(first); // 'a'
console.log(second); // 'b'

Personnalisation du comportement d'itération des tableaux

Bien que rarement nécessaire, vous pouvez remplacer la méthode par défaut du tableau[Symbol.iterator]()pour personnaliser le comportement d'itération :

Exemple

const customArray = [1, 2, 3];

customArray[Symbol.iterator] = function() {
  let index = this.length;
 
  return {
    next: () => {
      index--;
      return {
        value: this[index],
        done: index < 0
      };
    }
  };
};

for (const num of customArray) {
  console.log(num);
}
// Sortie :
// 3
// 2
// 1

Dans cet exemple, nous avons modifié l'itérateur pour que le tableau s'itère de l'arrière vers l'avant.


Comparaison avec d'autres méthodes d'itération

Différences avec forEach()

  • forEach()est une méthode de tableau qui exécute une fonction de rappel pour chaque élément
  • [Symbol.iterator]()retourne un objet itérateur, permettant un contrôle plus flexible sur le processus d'itération

Relation avec keys()/values()/entries()

Ces méthodes retournent toutes des itérateurs, mais elles ont des utilisations différentes :

  • keys(): renvoie un itérateur pour les indices du tableau
  • values(): renvoie un itérateur pour les éléments du tableau (identique à[Symbol.iterator]())
  • entries(): renvoie un itérateur pour les paires index/valeur

Compatibilité des navigateurs

Array [Symbol.iterator]()La méthode est prise en charge dans les environnements suivants :

  • Chrome 38+
  • Firefox 36+
  • Edge 12+
  • Safari 9+
  • Opera 25+
  • Node.js 0.12+

Résumé

Array [Symbol.iterator]()La méthode est essentielle pour que les tableaux JavaScript implémentent le protocole itérable. Comprendre comment cette méthode fonctionne peut vous aider à :

  1. Acquérir une compréhension plus approfondie du mécanisme d'itération de JavaScript
  2. Écrivez du code d'itération plus efficace
  3. Personnalisez le comportement d'itération si nécessaire

Rappelez-vous que dans la plupart des cas, vous n'avez pas besoin d'appeler cette méthode directement, carfor...ofles boucles et d'autres fonctionnalités du langage le gèrent en interne. Mais comprendre comment cela fonctionne fera de vous un meilleur développeur JavaScript.

Array 对象参考手册Objet Array JavaScript

Autres extensions