Array.prototype[@@iterator]()

@@iterator メソッドは反復プロトコルの一部であり、値の列を同期的に反復する方法を定義します。

@@iterator プロパティの初期値は values() プロパティの初期値と同じ関数オブジェクトです。

構文

arr[Symbol.iterator]()

返値

values() イテレーター によって与えられる初期値です。既定では、 arr[Symbol.iterator] を使うと values() を返します。

for...of ループを用いた反復

HTML

<ul id="letterResult">
</ul>

JavaScript

var arr = ['a', 'b', 'c'];
var eArr = arr[Symbol.iterator]();
var letterResult = document.getElementById('letterResult');
// your browser must support for..of loop
// and let-scoped variables in for loops
// const and var could also be used
for (let letter of eArr) {
 letterResult.innerHTML += "<li>" + letter + "</li>";
}

結果

他の反復方法

var arr = ['a', 'b', 'c', 'd', 'e'];
var eArr = arr[Symbol.iterator]();
console.log(eArr.next().value); // a
console.log(eArr.next().value); // b
console.log(eArr.next().value); // c
console.log(eArr.next().value); // d
console.log(eArr.next().value); // e

括弧表記の使用法

この構文をドット記法 (Array.prototype.values()) よりも優先して使用する場合は、事前にどのようなオブジェクトになるのかが分からない場合です。イテレータを受け取り、その値を反復処理する関数があるが、そのオブジェクトが [Iterable].prototype.values メソッドを持っているかどうかわからない場合です。これはStringオブジェクトのような組み込みオブジェクトでも、カスタムオブジェクトでもよいでしょう。これは String オブジェクトのような組込みオブジェクトや、独自オブジェクトである可能性があります。

function logIterable(it) {
  var iterator = it[Symbol.iterator]();
  // your browser must support for..of loop
  // and let-scoped variables in for loops
  // const and var could also be used
  for (let letter of iterator) {
      console.log(letter);
  }
}

// Array
logIterable(['a', 'b', 'c']);
// a
// b
// c

// string
logIterable('abc');
// a
// b
// c

仕様書

仕様書
ECMAScript (ECMA-262)
Array.prototype[@@iterator]() の定義

ブラウザーの互換性

BCD tables only load in the browser

関連情報