【JSリファレンス】Iteratorインターフェース

更新日:2024/06/14

Iteratorインターフェースは、オブジェクトをイテレータとして動作させるために必要なメソッド定義です。

メソッド名戻り値の型内容
nextIteratorResult次の形式で反復値を返す
反復値あり {done:false , value: 反復値}
反復値なし {done:true , value: undefined}
returnIteratorResult反復値の取得終了を
イテレーターに通知する。
戻り値は{done:true,value:return()の引数}
が推奨される
throw エラースローまたは
IteratorResult
呼び出し元でエラーが
検出されたことを
イテレーターに通知する。

通常は引数としてErrorオブジェクトを受け取る。
throw()内で例外をスローしないときは、
戻り値の doneプロパティに
true をセットする。

returnthrow は、オプションです。
実装されていなくてもイテレーターとして動作します。

 

■使用例

  // イテレーターを返す関数
const iterator = function(){
  const data = this.data.reverse();

  return {
    next:function(){
      return data.length ?
        { done:false , value:data.pop() }
        : { done:true  }
    }
  }
}
 // イテラブルなオブジェクト
const obj = {
  data:[1,2,3],
  [Symbol.iterator]:iterator
}
  // 値を列挙
for( const value of obj ){
  console.log( value );
}
// 結果:
// 1
// 2
// 3

 

関連ページ

更新日:2024/06/14

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

スポンサーリンク

記事の内容について

null

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

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

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

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

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

 

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