Widely available すべての主要ブラウザで対応済み。安心して使用可能。

Async generators

AsyncGenerator オブジェクトは非同期ジェネレーター関数から返されるもので、非同期反復可能プロトコルと非同期イテレータープロトコルの両方を満たすものです。

非同期ジェネレーターメソッドは、常に Promise オブジェクトを生成します。

AsyncGenerator は隠しクラスの AsyncIterator のサブクラスです。

言語コアES2018

対応ブラウザ

機能 デスクトップ モバイル
Chrome
Edge
Firefox
Safari
Chrome Android
Safari iOS
AsyncGenerator
63
79
55
12
63
12
AsyncGenerator.next

next() メソッドは、シーケンス内の次の値を返します。
63
79
55
12
63
12
AsyncGenerator.return

return() は AsyncGenerator インスタンスのメソッドで、あたかも return 文がジェネレーター本体の中の停止中の位置に挿入されたかのように動作し、ジェネレーターを終了して、try...finally ブロックと組み合わせた際に、ジェネレーターが任意のクリーンアップタスクを実行できるようにします。
63
79
55
12
63
12
AsyncGenerator.throw

throw() は AsyncGenerator インスタンスのメソッドで、あたかも throw 文がジェネレーター本体の中の停止中の位置に挿入されたかのように動作し、エラー状態をジェネレーターに通知して、エラーを処理するか、クリーンアップを実行してそれ自身を閉じることができます。
63
79
55
12
63
12
その他
javascript.builtins.AsyncGeneratorFunction

AsyncGeneratorFunction オブジェクトは、非同期ジェネレーター関数のメソッドを提供します。 JavaScript では、すべての非同期ジェネレータ関数は実際には AsyncGeneratorFunction オブジェクトです。
63
79
55
12
63
12
ビルトインオブジェクト
AsyncGeneratorFunction.AsyncGeneratorFunction

AsyncGeneratorFunction() コンストラクターは AsyncGeneratorFunction オブジェクトを生成します。
63
79
55
12
63
12
その他
javascript.functions.method_definitions.async_generator_methods

非同期ジェネレーター・メソッド
63
79
57
12
63
12
javascript.operators.async_generator_function

非同期関数*`式
63
79
57
12
63
12
javascript.statements.async_generator_function

非同期関数*`ステートメント
63
79
57
12
63
12
1+対応 (バージョン) 未対応 ※注釈あり サブ機能の解説は MDN Web Docs (CC BY-SA 2.5)

基本構文

JAVASCRIPT 
async function* fetchPages(url) {
  let page = 1;
  while (true) {
    const res = await fetch(`${url}?page=${page}`);
    const data = await res.json();
    if (data.length === 0) return;
    yield data;
    page++;
  }
}

for await (const page of fetchPages('/api/items')) {
  console.log(page);
}

ライブデモ

async function* Basics

asyncgenerator definition.await and yield combinationpossible. with async function*

プレビュー全画面表示

pe-jne-tion stylede-taread

pe-j per and to async in de-ta readsequentialoutputpattern.

プレビュー全画面表示

Normal generator and. Difference

different. with Yield value that sync/async, side that for...of / for await...of.

プレビュー全画面表示

実務での使いどころ

  • Async generators の活用

    AsyncGenerator オブジェクトは非同期ジェネレーター関数から返されるもので、非同期反復可能プロトコルと非同期イテレータープロトコルの両方を満たすものです。

注意点

  • 特になし。すべての主要ブラウザで安定して動作する。

アクセシビリティ

  • JavaScript による動的更新時は、aria-live リージョンで変更をスクリーンリーダーに通知する。

参考リンク