本文へ移動
プログラミング大全動かして、比べて、理解する。

JavaScript / コードを試す

TypeError: x is not iterable

for...of やスプレッドや分割代入に、回せないものを渡したときに出ます。素のオブジェクト、null、通信の結果。原因を多い順に並べ、それぞれ直したコードを載せています。

固定例はNode 24.22.3の実行記録を照合しています()。下の入力欄の結果は今回の実行で確認してください。

同じエラー名でも原因は異なります。発生した行とその時点の値を確かめ、該当する修正例へ進んでください。

元の教材を読む(別タブ)

コードを編集して試す

ブラウザー内で実行します。コードの送信・自動実行・自動保存はしません。このタブを閉じると入力は失われます。機密情報は入力しないでください。

playground.js

8,192 UTF-8 byte・実行1.5秒・出力60行/8KiB以内。Ctrl / ⌘ + Enterでも実行できます。

パネルを開くと編集できます。

現在の入力は未実行です。

今回の実行結果
JavaScriptUTF-8 · LF

実行画面や検索画面の間の通常クリックでは入力をこのタブのRAMで保持します。元の教材は別タブで開きます。再読み込み・タブ終了ではRAMの入力は失われます。

回せないものを、回そうとしたときに出ます。

javascript失敗・注意の例

for (const value of { a: 1, b: 2 }) {
  console.log(value);
}
固定例の期待出力 · Node 24.22.3
TypeError: {(intermediate value)(intermediate value)} is not iterable
表示用コードUTF-8 · LF

素のオブジェクトはfor...of で回せません。

{(intermediate value)} は「その場で書いたオブジェクト」という意味です。変数に入れて渡すと、代わりに変数の名前が出ます。

どこで出るか

for...of だけではありません。同じ仕組みを使う場所すべてで出ます。

example.js

const source = { a: 1 };

for (const fn of [
  () => { for (const x of source) console.log(x); },
  () => { const [first] = source; },
  () => { console.log([...source]); },
  () => { new Set(source); },
]) {
  try {
    fn();
  } catch (error) {
    console.log(error.name);
  }
}
固定例の期待出力 · Node 24.22.3
TypeError
TypeError
TypeError
TypeError
表示用コードUTF-8 · LF
書き方 例
for...of for (const x of value)
スプレッド [...value] / f(...value)
配列の分割代入 const [a] = value
Array.from() / new Set() / new Map() new Set(value)
Promise.all() Promise.all(value)

Symbol.iterator を持っているかどうかだけで決まります。 → 反復可能とイテレータ

原因1: 素のオブジェクトを回そうとした

いちばん多い原因です。

example.js

const scores = { a: 1, b: 2 };

for (const [key, value] of Object.entries(scores)) {
  console.log(key, value);
}

for (const key of Object.keys(scores)) {
  console.log(key);
}
固定例の期待出力 · Node 24.22.3
a 1
b 2
a
b
表示用コードUTF-8 · LF
欲しいもの 使うもの
鍵だけ Object.keys()
値だけ Object.values()
両方 Object.entries()

→ Object.keys() / values() / entries()

for...in でも回せますが、受け継いだ鍵まで拾うので勧めません。

原因2: null や undefined が来た

javascript失敗・注意の例

const list = null;

for (const value of list) {
  console.log(value);
}
固定例の期待出力 · Node 24.22.3
TypeError: list is not iterable
表示用コードUTF-8 · LF

文言に出るのは、書いた名前であって中身ではありません。 list が null なのか、素のオブジェクトなのかは、これだけでは分かりません。

まず中身を出してください。

example.js

const list = null;

console.log(list, typeof list, Array.isArray(list));
固定例の期待出力 · Node 24.22.3
null object false
表示用コードUTF-8 · LF

null や undefined だったなら、 回せない形なのではなく、値がまだ入っていないという意味です。

出どころをたどってください。 通信の失敗、まだ届いていない、鍵の綴り違い。

その場で凌ぐなら、空配列に倒します。

example.js

const list = null;

for (const value of list ?? []) {
  console.log(value);
}

console.log('落ちなかった');
固定例の期待出力 · Node 24.22.3
落ちなかった
表示用コードUTF-8 · LF

ただし、これは原因を隠す書き方でもあります。 「無いのが正常」なときにだけ使ってください。 → Cannot read properties of undefined

原因3: 配列だと思っていたものが違った

通信の結果は、中に包まれていることがよくあります。

javascript失敗・注意の例

const response = { items: [1, 2], total: 2 };

console.log([...response]);
固定例の期待出力 · Node 24.22.3
TypeError: response is not iterable
表示用コードUTF-8 · LF

response ではなく response.items が配列です。 まず中身を出して確かめてください。

example.js

const response = { items: [1, 2], total: 2 };

console.log(JSON.stringify(response));
console.log([...response.items]);
固定例の期待出力 · Node 24.22.3
{"items":[1,2],"total":2}
[ 1, 2 ]
表示用コードUTF-8 · LF

原因4: length があるだけの形

javascript失敗・注意の例

const fake = { length: 2, 0: 'a', 1: 'b' };

console.log([...fake]);
固定例の期待出力 · Node 24.22.3
TypeError: fake is not iterable
表示用コードUTF-8 · LF

length を持っていても、回せるとは限りません。 Array.from() なら扱えます。

example.js

const fake = { length: 2, 0: 'a', 1: 'b' };

console.log(Array.from(fake));
固定例の期待出力 · Node 24.22.3
[ 'a', 'b' ]
表示用コードUTF-8 · LF

→ Array.from() / Array.of() / new Array()

ブラウザの NodeList や HTMLCollection は、いまはどちらでも扱えます。古い環境向けの記事で Array.prototype.slice.call() を見かけますが、いま書く必要はありません。

原因5: オブジェクトを分割代入で受けた

javascript失敗・注意の例

const point = { x: 1, y: 2 };

const [x, y] = point;
固定例の期待出力 · Node 24.22.3
TypeError: point is not iterable
表示用コードUTF-8 · LF

角括弧と波括弧を取り違えています。

example.js

const point = { x: 1, y: 2 };

const { x, y } = point;

console.log(x, y);
固定例の期待出力 · Node 24.22.3
1 2
表示用コードUTF-8 · LF
  • [ ] … 並びから順番に取り出す(配列)
  • { } … 名前で取り出す(オブジェクト)

自分で回せるようにする

どうしてもそのオブジェクトを回したいなら、Symbol.iterator を持たせます。

example.js

const bag = {
  items: [1, 2],
  *[Symbol.iterator]() {
    yield* this.items;
  },
};

console.log([...bag]);
固定例の期待出力 · Node 24.22.3
[ 1, 2 ]
表示用コードUTF-8 · LF

ただし、ふつうは Object.entries() で足ります。 自作するのは、独自の順序や終わりの条件があるときだけにしてください。

探しかたの順序

  1. 文言に出ている名前を探す。それが中身を教えてくれるわけではない
  2. その値を console.log() と typeof で出す
    • null / undefined だった → 値の出どころを疑う。回し方の問題ではない
    • 素のオブジェクトだった → Object.entries() を挟む
    • 中に配列が入っていた → そちらを渡す
  3. 分割代入なら、[ ] と { } を見直す

実行結果は、記事冒頭に示したNodeの版で確認しています。文言は処理系と版によって変わります。自分の環境で出た文言で検索してください。

まとめ

  • 出るのは for...of・スプレッド・配列の分割代入・new Set() など
  • 判定はSymbol.iterator を持つかだけ
  • 素のオブジェクトは回せない。 Object.entries() を挟む
  • 文言に出るのは書いた名前で、中身ではない。 まず値を出して見る
  • 値が null / undefined だったなら、出どころの問題
  • length があるだけの形は Array.from() で扱う
  • [ ] と { } の取り違えでも出る

出典

この教材の原文(Markdown・別タブ)