Promise.race([]) 返回永久 pending 的 Promise,因规范要求等待首个敲定的 Promise,空数组无候选者;既不 resolve 也不 reject,以保持中立可观察性。

因为规范明确要求:当 Promise.race 接收一个空的可迭代对象(如空数组)时,必须返回一个永远不会 resolve 也不会 reject 的 Promise —— 即永久 pending。
规范依据:ECMA-262 标准行为
根据 ECMAScript 官方规范(ECMA-262),Promise.race 的语义是“等待第一个 Promise 敲定”。如果输入中根本不存在任何 Promise,那就没有“第一个”可等待的对象。此时无法触发 resolve 或 reject,所以唯一符合逻辑且可预测的行为就是保持 pending 状态,不终止、不抛错、也不降级为立即 rejected。
为什么不能自动 resolve 或 reject?
自动 resolve(比如返回 Promise.resolve())或 reject 会违背 race 的设计意图:它本应反映“竞争结果”,而不是兜底逻辑。开发者需自行判断空数组是否合法场景;语言层不替你做业务决策。
- 若空数组被 resolve,调用方可能误以为“所有任务都完成了”,但实际什么都没发生
- 若空数组被 reject,则相当于把输入错误(如漏传数据)变成运行时异常,掩盖了真实问题
- 保持 pending 是最中立、最可观察的行为:它会一直挂起,容易在调试中暴露逻辑疏漏
实际代码表现
以下代码会永远卡住,不会进入 then 或 catch:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记(深入)”;
const p = Promise.race([]);p.then(() => console.log('never'));
p.catch(() => console.log('also never'));
这个 Promise 没有微任务入队,也没有状态变更路径,内部没有任何机制去结束它 —— 这正是规范强制规定的“无操作”行为。
如何安全处理空数组?
业务中遇到可能为空的数组时,建议显式校验:
- 提前过滤掉空情况:
arr.length === 0 ? Promise.resolve(defaultValue) : Promise.race(arr) - 用
Promise.any替代(注意:它对空数组会 reject,行为不同) - 封装一层工具函数,统一处理边界条件,避免散落各处的 if 判断

















