【JavaScript ECMAScript】Iterator::Iterator.prototype.takeインスタンスメソッドの使い方

Iterator.prototype.take()メソッドは、既存のイテレーターから指定された数の要素だけを取り出し、新しいイテレーターを生成するメソッドです。このメソッドは、countという数値の引数を受け取ります。countには、新しいイテレーターが提供する要素の最大数を指定します。

具体的には、元のイテレーターから最初のcount個の要素を順に取得し、それらの要素を返す新しいイテレーターを作成します。新しいイテレーターは、count個の要素を返し終えると、それ以降のnext()呼び出しに対してはdone: trueを返して終了します。これにより、元のイテレーターが持つ残りの要素は処理されません。

このメソッドは、例えば、大量のデータを含むイテレーターから特定の数の先頭要素のみを効率的に処理したい場合に非常に有用です。データベースのクエリ結果から最初の数件だけ表示する場合や、大きなファイルの内容を一部だけプレビューする場合など、リソースの消費を抑えつつ必要な部分だけを扱うのに適しています。

count引数が負の数やゼロの場合、Iterator.prototype.take()は要素を一つも返さない空のイテレーターを生成します。また、countが元のイテレーターの残りの要素数よりも大きい場合、元のイテレーターのすべての要素を返します。このように、必要な要素数だけを安全かつ確実に取得できる柔軟性を提供します。

Copy
1const originalIterator = [1, 2, 3, 4, 5][Symbol.iterator]();
2const limitedIterator = originalIterator.take(3);

limit

• limit: number: 生成されるイテレータの要素数の上限を指定する数値

Iterator

指定された Iterator.prototype.take() メソッドは、元のイテレータから指定された数の要素のみを順に取り出す新しいイテレータを返します。この返されるイテレータは、元のイテレータの要素のうち、最大で指定された数までを生成します。