TypeScript报错：类型需有返回迭代器的Symbol.iterator方法求助

你碰到的这个错误提示“Type must have a 'Symbol.iterator' method that returns an iterator”，本质是因为扩展运算符[...]只支持同步可迭代对象，而你代码里的this.test()返回的是AsyncIterableIterator<string>——也就是异步迭代器，它只有异步迭代的接口[Symbol.asyncIterator]，没有同步迭代需要的[Symbol.iterator]，所以TypeScript会直接报错。

先看你出错的代码：

class Test {
  private async do() {
    const done = [...(await this.test())]; // 此处报错
  }
  private async *test(): AsyncIterableIterator<string> {
    return;
  }
}

两种可行的解决方案： #

方案1：用for await...of手动收集结果

这是最直接的方式，专门用来遍历异步迭代器：

class Test {
  private async do() {
    const done: string[] = [];
    // 用for await...of遍历异步迭代器
    for await (const item of this.test()) {
      done.push(item);
    }
    // 现在done就是收集到的数组了
  }
  private async *test(): AsyncIterableIterator<string> {
    // 这里可以添加实际的异步迭代逻辑，比如：
    // yield 'first item';
    // await new Promise(resolve => setTimeout(resolve, 100));
    // yield 'second item';
    return;
  }
}

方案2：封装工具函数统一转换

如果需要多次处理异步迭代器转数组，可以写一个复用的工具函数：

// 工具函数：把异步可迭代对象转成数组
async function asyncIterableToArray<T>(iter: AsyncIterable<T>): Promise<T[]> {
  const result: T[] = [];
  for await (const item of iter) {
    result.push(item);
  }
  return result;
}

class Test {
  private async do() {
    // 调用工具函数，await拿到数组结果
    const done = await asyncIterableToArray(this.test());
  }
  private async *test(): AsyncIterableIterator<string> {
    return;
  }
}

补充说明 #

你之前在TypeScript仓库找的问题建议加lib条目，其实没必要——这不是TypeScript的bug，而是异步迭代器和同步迭代器的设计差异导致的。ES6的扩展运算符从一开始就只针对同步可迭代对象，异步场景就得用专门的异步遍历语法或者手动处理。

内容的提问来源于stack exchange，提问作者Tomáš Hübelbauer