Symbol.asyncIterator

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Le symbole connu Symbol.asyncIterator définit l'itérateur asynchrone par défaut d'un objet. Si cette propriété est définie sur un objet, celui-ci est un itérable asynchrone et peut être utilisé avec une boucle for await...of.

Attributs de Symbol.asyncIterator
ÉcrivableNon
ÉnumérableNon
ConfigurableNon

Description

Le symbole Symbol.asyncIterator est un symbole natif utilisé pour accéder à la méthode @@asyncIterator d'un objet. Pour qu'un objet soit un itérable asynchrone, il doit avoir une clé Symbol.asyncIterator.

Exemples

Itérable asynchrone personnalisé

Il est possible de définir son propre itérable en définissant la propriété [Symbol.asyncIterator] d'un objet :

js
const myAsyncIterable = new Object();
myAsyncIterable[Symbol.asyncIterator] = async function* () {
  yield "coucou";
  yield "l'itération";
  yield "asynchrone !";
};

(async () => {
  for await (const x of myAsyncIterable) {
    console.log(x);
    // expected output:
    //    "coucou"
    //    "l'itération"
    //    "asynchrone !"
  }
})();

Itérables asynchrones natifs

Il n'existe actuellement pas d'objets JavaScript natifs qui possèdent la clé [Symbol.asyncIterator] par défaut. Toutefois, les flux (Streams) WHATWG pourraient devenir les premiers objets natifs itérables asynchrones.

Spécifications

Specification
ECMAScript Language Specification
# sec-symbol.asynciterator

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi