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

Iterator.prototype.toArray()メソッドは、イテレーターから生成されるすべての要素を新しい配列として取得するメソッドです。

JavaScriptにおいてイテレーターは、配列やMap、Setなどの反復可能なオブジェクトから、要素を一つずつ順番に取り出すための標準的な仕組みを提供します。この toArray() メソッドは、イテレータープロトタイプに追加された比較的新しい機能であり、特定のイテレーターが最終的に生成するであろう全ての値を、新しい配列として一度にまとめて収集するために使用されます。

このメソッドの主な目的は、イテレーターによって提供される一連の値を、配列として操作したい場合に簡潔かつ効率的な方法を提供することです。例えば、カスタムのイテレーターや、Map.prototype.entries() のようにイテレーターを返すメソッドの結果を、Array.prototype.map() や Array.prototype.filter() といった配列操作メソッドで加工したい場合などに非常に便利です。

toArray() メソッドを呼び出すと、イテレーターの next() メソッドが呼び出され続け、done: true が返されるまですべての値が抽出されます。そして、これらの抽出された値が要素として含まれる新しい配列が生成され、返されます。この操作によって元のイテレーターは完全に消費されますが、呼び出しごとに常に新しい配列が作成されるため、元のイテレーターや他のデータには影響を与えません。これにより、イテレーターの値を配列として利用する際のコードの可読性と保守性が向上します。

Copy
1const iterator = [1, 2, 3][Symbol.iterator]();
2const array = iterator.toArray();

引数なし

引数はありません

Array

イテレータが生成する全ての要素を格納した配列を返します。