Wikimore

Iterator.prototype

Iterator.prototype は、JavaScript言語における反復可能なオブジェクトのプロトタイプインターフェースを定義します。

概要

Iterator（イテレータ）は、JavaScriptにおけるコレクションやデータストリームを順次処理するための標準的な方法を提供するオブジェクトです。

プロトタイプメソッド

next()

イテレータの次の値を取得するための基本的なメソッドです。

戻り値

オブジェクト { value: any, done: boolean }

value: 現在の要素の値

done: イテレーションが完了したかどうかを示すブール値

使用例

// 配列からイテレータを取得
const iterator = ['a', 'b', 'c'].values();

console.log(iterator.next()); // { value: 'a', done: false }
console.log(iterator.next()); // { value: 'b', done: false }
console.log(iterator.next()); // { value: 'c', done: false }
console.log(iterator.next()); // { value: undefined, done: true }

return()

イテレーションを早期に終了し、最終値を返すメソッドです。

パラメータ: value (オプション): 返される値

使用例

const iterator = [1, 2, 3].values();

console.log(iterator.return()); // { value: undefined, done: true }

throw()

イテレータ内でエラーを発生させるメソッドです。

パラメータ: error: 発生させる例外オブジェクト

使用例

function* generatorFunction() {
    try {
        yield 1;
        yield 2;
    } catch (e) {
        console.log('エラーをキャッチ:', e);
    }
}

const iterator = generatorFunction();
iterator.next(); // { value: 1, done: false }
iterator.throw(new Error('カスタムエラー')); // エラーをキャッチ: Error: カスタムエラー

生成方法

Iteratorは直接生成せず、以下の方法で作成されます：

コレクションメソッド

ジェネレータ関数

function* numberGenerator() {
    yield 1;
    yield 2;
    yield 3;
}

const iterator = numberGenerator();

反復可能プロトコル

Iteratorは、Symbol.iterator メソッドを実装することで、for...ofループや分割代入など、JavaScriptの反復処理機能と連携できます。

ブラウザサポート

モダンなブラウザと最新のJavaScriptエンジンで広くサポートされています。古いブラウザでは、トランスパイラやポリフィルが必要な場合があります。

プロパティ

Iterator.prototype [ Symbol.toStringTag ]

メソッド

Iterator.prototype.constructor()

Iterator.prototype.drop()
Iterator.prototype.every()
Iterator.prototype.filter()
Iterator.prototype.find()
Iterator.prototype.flatMap()
Iterator.prototype.forEach()
Iterator.prototype.map()
Iterator.prototype.reduce()
Iterator.prototype.some()
Iterator.prototype.take()
Iterator.prototype.toArray()
Iterator.prototype [ Symbol.iterator ] ()

注意点

Iteratorは一方向で、巻き戻しができません
一度すべての要素を取得すると、再度イテレーションできません

カテゴリ:JavaScript