この記事は技術レビューを必要としています。ぜひご協力ください

この記事は編集レビューを必要としています。ぜひご協力ください

for...ofは、それぞれのプロパティの値に対して実行する文とともに独自の反復処理を呼び出す、(Array, Map, Set, String, TypedArray, 引数オブジェクトなどを含む)iterable objectsに反復するループを作成します。

構文

for (variable of iterable) {
  statement
}
variable
それぞれの反復処理において、別々のプロパティの値が variable に代入されます。
iterable
列挙可能なプロパティに対して、反復処理を行うオブジェクトです。

Arrayで反復する:

let iterable = [1, 2, 3];

for (let value of iterable) {
  console.log(value);
}
// 1
// 2
// 3

Stringで反復する:

let iterable = "boo";

for (let value of iterable) {
  console.log(value);
}
// "b"
// "o"
// "o"

TypedArrayで反復する:

let iterable = new Uint8Array([0x00, 0xff]);

for (let value of iterable) {
  console.log(value);
}
// 0
// 255

Mapで反復する:

let iterable = new Map([["a", 1], ["b", 2], ["c", 3]]);

for (let entry of iterable) {
  console.log(entry);
}
// [a, 1]
// [b, 2]
// [c, 3]

for (let [key, value] of iterable) {
  console.log(value);
}
// 1
// 2
// 3

Setで反復する:

let iterable = new Set([1, 1, 2, 2, 3, 3]);

for (let value of iterable) {
  console.log(value);
}
// 1
// 2
// 3

DOMコレクションで反復する

NodeListのようなDOMコレクションで反復する場合、次の例はreadクラスをarticleの直系の子孫である段落(p)に加えます:

// 注:特定のプラットホームでのみ動作します
// implemented NodeList.prototype[Symbol.iterator]
let articleParagraphs = document.querySelectorAll("article > p");

for (let paragraph of articleParagraphs) {
  paragraph.classList.add("read");
}

ジェネレーターで反復する

ジェネレーター(function*で反復することもできます:

function* fibonacci() { // ジェネレーター関数
  let [prev, curr] = [1, 1];
  while (true) {
    [prev, curr] = [curr, prev + curr];
    yield curr;
  }
}

for (let n of fibonacci()) {
  console.log(n);
  // 1000でシーケンスを打ち切る
  if (n >= 1000) {
    break;
  }
}

for...offor...inとの違い

for...inループは、オブジェクトのすべてのenumerableなプロパティを反復します。

for...of構文は、全オブジェクトよりもむしろ、コレクションに特有です。これは、[Symbol.iterator]プロパティを持つ任意のプロパティの要素全体をこの方法で反復します。

次の例は、for...ofループとfor...inループとの間の違いを示します。

Object.prototype.objCustom = function () {}; 
Array.prototype.arrCustom = function () {};

let iterable = [3, 5, 7];
iterable.foo = "hello";

for (let i in iterable) {
  console.log(i); // logs 0, 1, 2, "foo", "arrCustom", "objCustom"
}

for (let i of iterable) {
  console.log(i); // logs 3, 5, 7
}

仕様

仕様 Status Comment
ECMAScript 2015 (6th Edition, ECMA-262)
for...of statement の定義
標準 初期定義。
ECMAScript 2017 Draft (ECMA-262)
for...of statement の定義
ドラフト  

ブラウザー互換性

機能 Chrome Firefox (Gecko) Edge Opera Safari
基本サポート 38 [1] 13 (13) [2] 12 25 7.1
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート ? 38 [1] 13.0 (13) [2] ? ? 8

[1] Chrome 29からChrome 37まで、この機能は設定から隠されていました。chrome://flags/#enable-javascript-harmonyで、“Enable Experimental JavaScript”をアクティブにします。

[2] Gecko 17 (Firefox 17 / Thunderbird 17 / SeaMonkey 2.14)からGecko 26 (Firefox 26 / Thunderbird 26 / SeaMonkey 2.23 / Firefox OS 1.2)まで、iteratorプロパティが使用され(bug 907077)、Gecko 27からGecko 35まで"@@iterator"プレースホルダーが使用されていました。Gecko 36 (Firefox 36 / Thunderbird 36 / SeaMonkey 2.33)で、@@iterator symbolが実装されました(bug 918828)。

関連情報

ドキュメントのタグと貢献者

 このページの貢献者: isdh, momdo, hashedhyphen, teoli, yyss
 最終更新者: isdh,