Promise.any 适用于多 CDN 场景中“取最快成功响应”,它在任意 Promise 成功时立即返回结果,忽略失败项;而 Promise.race 可能因首个失败导致整体失败,Promise.all 要求全部成功,均不满足容错与快速加载需求。

Promise.any 是 JavaScript 中用于并发请求场景的实用工具,特别适合多 CDN 备份环境下的“取最快成功响应”策略——它会在任意一个 Promise 成功时立即返回结果,其余请求可继续运行但结果被忽略,从而兼顾加载速度与容错能力。
为什么用 Promise.any 而不是 Promise.race 或 Promise.all
在多 CDN 场景中,目标是“只要有一个 CDN 返回有效资源就立刻使用”,而非“谁快谁赢(可能返回错误)”或“必须全部成功”。
- Promise.race 会把第一个 settled(包括 reject)的结果直接抛出,若首个 CDN 网络超时或返回 404,整个请求就失败,不符合容错需求;
- Promise.all 要求全部成功,延迟由最慢 CDN 决定,违背“快速获取”初衷;
- Promise.any 只关心首个 fulfilled,自动忽略 reject,天然匹配“任一可用即采用”的语义。
基础实现:并发加载多个 CDN 的同一资源
以加载一个 JS 脚本为例,构造多个 CDN 域名的 fetch 请求:
const cdnUrls = [
'https://cdn-a.example.com/lib.js',
'https://cdn-b.example.com/lib.js',
'https://cdn-c.example.com/lib.js'
];
<p>const loadScriptFromAnyCdn = async () => {
const promises = cdnUrls.map(url =>
fetch(url)
.then(res => {
if (!res.ok) throw new Error(<code>HTTP ${res.status}</code>);
return res.text(); // 或 res.blob() / res.json()
})
.catch(err => Promise.reject({ url, error: err.message }))
);</p><p>try {
const content = await Promise.any(promises);
console.log('✅ 加载成功,来自最快 CDN');
return content;
} catch (errors) {
// errors 是 AggregateError,包含所有 reject 原因
console.error('❌ 所有 CDN 均不可用', errors.errors);
throw errors;
}
};
</p>进阶优化:控制并发、添加超时、标记来源
真实场景需防止请求堆积、避免无限等待,并明确知道资源来自哪个节点:
- 添加单请求超时:每个 fetch 包裹 setTimeout 或用 AbortController,避免某个 CDN 卡死拖慢整体;
- 限制并发数:若 CDN 列表很长(如 10+),可用 p-limit 等库控制同时发起请求数量,避免浏览器连接耗尽;
-
返回带来源信息的结果:在 resolve 时附带 url,便于监控和灰度分析,例如
resolve({ url, content }); - 配合缓存策略:首次成功后,可将该 CDN 地址写入 localStorage,后续优先尝试该节点(需搭配降级逻辑防固化失效)。
注意事项与兼容性兜底
Promise.any 在 Safari 15.4+、Chrome 93+、Firefox 93+ 支持,旧环境需 polyfill(如 core-js)或手动模拟:
- 手动模拟思路:用 Promise.all + 自定义状态计数器,记录首个成功项并 resolve,其余 reject 后静默丢弃;
- 注意:不要用 Promise.race + 错误过滤替代,否则无法区分“首个失败”和“首个成功”;
- 若资源为 script 标签注入(非 fetch),需封装成 Promise,监听 onload/onerror 并正确 resolve/reject。

















