--- title: 'Array.prototype[@@iterator]()' slug: Web/JavaScript/Reference/Global_Objects/Array/@@iterator tags: - Array - Beginner - ECMAScript 2015 - Iterator - JavaScript - Method - Prototype - Reference - イテレーター - メソッド translation_of: Web/JavaScript/Reference/Global_Objects/Array/@@iterator ---
{{JSRef}}

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

@@iterator プロパティの初期値は {{jsxref("Array.prototype.values()", "values()")}} プロパティの初期値と同じ関数オブジェクトです。

構文

arr[Symbol.iterator]()

返値

{{jsxref("Array.prototype.values()", "values()")}} イテレーター によって与えられる初期値です。既定では、 arr[Symbol.iterator] を使うと {{jsxref("Array.prototype.values()", "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>";
}

結果

{{EmbedLiveSample('Iteration_using_for...of_loop', '', '', '', 'Web/JavaScript/Reference/Global_Objects/Array/@@iterator')}}

他の反復方法

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

仕様書

仕様書
{{SpecName('ESDraft', '#sec-array.prototype-@@iterator', 'Array.prototype[@@iterator]()')}}

ブラウザーの互換性

{{Compat("javascript.builtins.Array.@@iterator")}}

関連情報