TypeError: 'x' is not iterable
当以下值不是可迭代对象时,会发生 JavaScript 异常“不可迭代”:扩展到数组或函数调用的值,作为for...of的右侧,作为Promise.all或Set()等函数的参数,或者作为数组解构的右侧。当Array.fromAsync()或for await...of与非异步可迭代对象一起使用时,也会遇到此错误。
消息
TypeError: Spread syntax requires ...iterable[Symbol.iterator] to be a function (V8-based & Safari) TypeError: %Array%.from requires that the property of the first argument, items[Symbol.iterator], when exists, be a function (V8-based & Safari) TypeError: Array.fromAsync requires that the property of the first argument, items[Symbol.asyncIterator], when exists, be a function (V8-based & Safari) TypeError: object is not iterable (cannot read property Symbol(Symbol.iterator)) (V8-based) TypeError: x is not async iterable (V8-based) TypeError: x is not iterable (V8-based & Firefox) TypeError: undefined is not a function (near '...y of x...') (Safari) TypeError: Array.from: no function (Safari) TypeError: Type error (Safari)
错误类型
TypeError
哪里出错了?
扩展到数组或函数调用、作为for...of的右侧、作为Promise.all或Set()等函数的参数,或者作为数组解构模式源的值不是可迭代对象。可迭代对象可以是内置的可迭代类型,例如Array、String或Map,生成器结果,或者实现可迭代协议的对象。
js
const nonIterable1 = {};
const nonIterable2 = { [Symbol.iterator]: 1 };
[...nonIterable1];
Math.max(...nonIterable1);
for (const x of nonIterable1);
new Set(nonIterable1);
Array.from(nonIterable2);
new Int8Array(nonIterable2);
const [] = nonIterable1;
示例
解构非可迭代数组
js
const myObj = { arrayOrObjProp1: {}, arrayOrObjProp2: [42] };
const {
arrayOrObjProp1: [value1],
arrayOrObjProp2: [value2],
} = myObj; // TypeError: object is not iterable
console.log(value1, value2);
在某些运行时环境中,非可迭代对象可能会变为undefined。
迭代对象属性
在 JavaScript 中,Object除非实现可迭代协议,否则不可迭代。因此,您不能使用for...of迭代对象的属性。
js
const obj = { France: "Paris", England: "London" };
for (const p of obj) {
// …
} // TypeError: obj is not iterable
相反,您必须使用Object.keys或Object.entries来迭代对象的属性或条目。
js
const obj = { France: "Paris", England: "London" };
// Iterate over the property names:
for (const country of Object.keys(obj)) {
const capital = obj[country];
console.log(country, capital);
}
for (const [country, capital] of Object.entries(obj)) {
console.log(country, capital);
}
此用例的另一个选项可能是使用Map
js
const map = new Map();
map.set("France", "Paris");
map.set("England", "London");
// Iterate over the property names:
for (const country of map.keys()) {
const capital = map.get(country);
console.log(country, capital);
}
for (const capital of map.values()) {
console.log(capital);
}
for (const [country, capital] of map.entries()) {
console.log(country, capital);
}
迭代生成器
生成器函数是您调用以生成可迭代对象的函数。
js
function* generate(a, b) {
yield a;
yield b;
}
for (const x of generate) {
console.log(x);
} // TypeError: generate is not iterable
当它们未被调用时,与生成器对应的Function对象是可调用的,但不可迭代。调用生成器会生成一个可迭代对象,该对象将在生成器执行期间迭代产生的值。
js
function* generate(a, b) {
yield a;
yield b;
}
for (const x of generate(1, 2)) {
console.log(x);
}
迭代自定义可迭代对象
可以通过实现Symbol.iterator方法来创建自定义可迭代对象。您必须确保您的迭代器方法返回一个迭代器对象,也就是说它必须有一个 next 方法。
js
const myEmptyIterable = {
[Symbol.iterator]() {
return []; // [] is iterable, but it is not an iterator — it has no next method.
},
};
Array.from(myEmptyIterable); // TypeError: myEmptyIterable is not iterable
这是一个正确的实现
js
const myEmptyIterable = {
[Symbol.iterator]() {
return [][Symbol.iterator]();
},
};
Array.from(myEmptyIterable); // []