Iterator

概要

レガシーイテレータプロトコルを実装し、オブジェクトの列挙可能なプロパティに対して反復するオブジェクトを返します。

構文

Iterator(object, [keyOnly])

引数

object

プロパティを反復処理するオブジェクト。

keyOnly

keyOnly が truthy な値である場合は、Iterator.prototype.next が property_name のみ返します。

説明

使用方法の概要がIterators and Generatorsページで提供されています。

メソッド

Iterator.prototype.next

[property_name, property_value]フォーマットで次のアイテムを返します。それ以上のアイテムが存在しない場合、StopIterationをスローします。

例

オブジェクトのプロパティを反復処理する

var a = {
  x: 10,
  y: 20,
};
var iter = Iterator(a);
console.log(iter.next()); // ["x", 10]
console.log(iter.next()); // ["y", 20]
console.log(iter.next()); // throws StopIteration

レガシーデストラクタfor-in文を使用してオブジェクトのプロパティを反復処理する

var a = {
  x: 10,
  y: 20,
};

for (var [name, value] in Iterator(a)) {
  console.log(name, value);   // x 10
                              // y 20
}

for-ofとともにイテレータを使用する

var a = {
  x: 10,
  y: 20,
};

for (var [name, value] of Iterator(a)) {  // @@iterator is used
  console.log(name, value);   // x 10
                              // y 20
}

仕様

非標準。すべての現在の仕様書でサポートされていません。

ブラウザ実装状況

サポートされていません。バージョン 57 より前の Firefox でサポートしていました。

関連情報

• Iterators and Generators
• StopIteration