JavaScript中迭代器（Iterator）的类型是什么？

我可以实现自定义生成器函数，它返回一个Generator。对应的类型可以这样定义：

type Iterable = { [Symbol.iterator](): Generator };

但这个类型对Array这类内置类型并不适用——这是因为内置类型被设计为可多次迭代，而非仅能迭代一次。

Array的Symbol.iterator方法会返回“新数组迭代器对象”，如果要定义适配内置类型的可迭代类型，可以写成：

type IterableBuiltIn = { [Symbol.iterator](): { next: any, value: any, return: any };

const array: IterableBuiltIn = [1, 2, 3];
for (const value in array) {
    console.log(value);
}

内容的提问来源于stack exchange，提问作者James T.