Symbol.iterator

よく知られた Symbol.iterator シンボルはオブジェクトに対するデフォルトイテレーターを指定します。for...of によって使われます。

説明

(for..of ループの始まりのときのように) オブジェクトが反復される必要があるときはいつでも、@@iterator メソッドは引数なしで呼ばれます。返された iterator は反復される値を取得するために使用されます。

デフォルトの反復動作を持っている組み込み型もあれば、(Object のような) 持っていない型もあります。@@iterator メソッドをもつ組み込み型は下記の通りです。:

• Array.prototype[@@iterator]()
• TypedArray.prototype[@@iterator]()
• String.prototype[@@iterator]()
• Map.prototype[@@iterator]()
• Set.prototype[@@iterator]()

詳細については、反復処理プロトコルも確かめて下さい。

例

ユーザ定義イテレーター

このように独自のイテレーターを作ることができます。:

var myIterable = {}
myIterable[Symbol.iterator] = function* () {
    yield 1;
    yield 2;
    yield 3;
};
[...myIterable] // [1, 2, 3]

非整形イテレーター

iterable の @@iterator メソッドがイテレータオブジェクトを返さない場合、それは非整形イテレータです。そのように使用すると、実行時例外またはバグが発生する可能性があります:

var nonWellFormedIterable = {}
nonWellFormedIterable[Symbol.iterator] = () => 1
[...nonWellFormedIterable] // TypeError: [] is not a function

仕様

ブラウザ実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

関連情報

• 反復処理プロトコル
• Array.prototype[@@iterator]()
• TypedArray.prototype[@@iterator]()
• String.prototype[@@iterator]()
• Map.prototype[@@iterator]()
• Set.prototype[@@iterator]()