← Back To API Reference

Promise.each

Promise.each(
    Iterable<any>|Promise<Iterable<any>> input,
    function(any item, int index, int length) iterator
) -> Promise

本文部分或完全未完成。 欢迎大家来创建 pull 请求 来帮助完成这篇文章。

使用给定的 iterator 函数迭代一个数组,或一个数组(它包含 promises(或 promsies 与值的混合))的 promise。该函数签名为 (value, index, length) ,其中 value 是输入数组种的各个 promise 的解决值。迭代串行地发生。如果迭代器返回一个 promise 或 thenable,然后下一个迭代将等待该 promise 的结果。如果输入数组中的任何 promise 被拒绝,返回的 promise 都将是拒绝的。

如果所有的迭代都成功解决,Promise.each 解决为未修改的原始数组。但是,如果有一个迭代拒绝或错误,Promise.each 立即停止执行,并且不处理任何进一步的迭代。在这种情况下返回错误或被拒绝的值而不是原始数组。

这个方法是用来做副作用的。