【JSリファレンス】%AsyncGeneratorPrototype%.next()

更新日:2024/06/14

%AsyncGeneratorPrototype%.next()は、%AsyncGeneratorPrototype%オブジェクトのメソッドです。

このメソッドは、AsyncGeneratorオブジェクト非同期イテレーターとしての機能を提供する、AsyncIteratorインターフェースの一部です。

メソッドを実行すると、非同期ジェネレーター関数内の次の yieldキーワードまで処理が進み、Promiseを返します。
このPromiseは、yieldキーワードの右辺値をvalueプロパティに持つIteratorResultインターフェースに準拠したオブジェクトで解決します。
yieldキーワードの右辺値がPromiseの場合は、そのPromiseの履行値が、valueプロパティにセットされます。

最後のyieldまで値を取得した、または%AsyncGeneratorPrototype%.return()および%AsyncGeneratorPrototype%.throw()の呼び出し後にnext()を呼び出すと、doneプロパティの値がtrueのオブジェクトで解決するPromiseを返します。

 

■構文

%AsyncGeneratorPrototype%.next( value )
  1. value: 前回のyieldキーワードの戻り値
次のIteratorResultインターフェースを実装したオブジェクトで解決するPromise
{done:ブール値 , value: 何らかの値}

 

■使用例

  // 500ミリ秒待機するPromise
const sleep500 = (value)=> new Promise(
  resolve =>setTimeout( 
    ()=>resolve(
      `500ミリ秒待機しました(${value})`
    )
  , 500 )
 );


  // GeneratorFunctionコンストラクターから
  // GeneratorFunctionオブジェクト生成
const asyncGeneratorFunctionObj = async function*(a,b,c){
   yield sleep500(a);
   yield sleep500(b);
   yield sleep500(c);
};


  // AsyncGeneratorFunctionオブジェクトから
  // AsyncGeneratorオブジェクトを生成
const asyncGenerator = asyncGeneratorFunctionObj(1,2,3);

asyncGenerator.next()
.then(e=>{
    console.log(e);
    return asyncGenerator.next();
  })
.then(e=>{
    console.log(e);
    return asyncGenerator.next();
  })
.then(e=>{
    console.log(e);
    return asyncGenerator.next();
  })
.then(e=>{
    console.log(e);
  });
// 結果:
// { value: '500ミリ秒待機しました(1)', done: false }
// { value: '500ミリ秒待機しました(2)', done: false }
// { value: '500ミリ秒待機しました(3)', done: false }
// { value: undefined, done: true }

更新日:2024/06/14

書いた人(管理人):けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない?」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。