for await...of

for await...of 文は非同期（と同期）の反復オブジェクトを繰り返して処理するループを作ります。対象の反復オブジェクトは、ビルトインの String、Array、配列様オブジェクト（ arguments、NodeList 等)、TypedArray、Map、Set、さらに、ユーザーが定義した非同期・同期の反復オブジェクトが含まれます。オブジェクトの各プロパティの値に対して実行されるステートメントを使用してカスタム反復フックを呼び出します。

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

構文

for await (variable of iterable) {
  statement
}

variable

反復ごとに、異なるプロパティの値が variable に割り当てられます。

iterable

反復可能プロパティが反復処理されるオブジェクトです。

非同期反復オブジェクトを繰り返し処理する

非同期反復可能プロトコルを明示的に実装しているオブジェクトを反復処理することができます:

var asyncIterable = {
  [Symbol.asyncIterator]() {
    return {
      i: 0,
      next() {
        if (this.i < 3) {
          return Promise.resolve({ value: this.i++, done: false });
        }

        return Promise.resolve({ done: true });
      }
    };
  }
};

(async function() {
   for await (num of asyncIterable) {
     console.log(num);
   }
})();

// 0
// 1
// 2

非同期ジェネレータを繰り返し処理する

非同期反復可能プロトコルを実装している async generator であれば、for await...of を使用して繰り返し処理できます:

async function* asyncGenerator() {
  var i = 0;
  while (i < 3) {
    yield i++;
  }
}

(async function() {
  for await (num of asyncGenerator()) {
    console.log(num);
  }
})();
// 0
// 1
// 2

仕様

ブラウザー実装状況

関連情報

• Statements/for...of