javascript 的 promise.any 返回第一个成功完成的结果;较早发生的失败不会直接让它失败。只有全部输入都失败时,返回的 promise 才以 aggregateerror 拒绝。以下示例使用 node.js 18 及以上,分别保存为 demo.cjs 后执行 node demo.cjs;示例中的定时器不发起网络请求。

允许部分任务失败,等待第一个成功结果
把多个 Promise 组成数组传入 any。这里失败任务先结束,随后第一个成功任务提供结果,较慢的成功任务不会改写已确定的结果。末尾 catch 只负责让未预期的异常以非零退出码暴露。
const assert = require('node:assert/strict');
const later = (value, ms, fail = false) => new Promise((resolve, reject) => {
setTimeout(() => fail ? reject(new Error(value)) : resolve(value), ms);
});
(async () => {
const result = await Promise.any([
later('失败 A', 5, true),
later('成功 B', 15),
later('成功 C', 30)
]);
assert.equal(result, '成功 B');
console.log(result);
})().catch(error => { console.error(error); process.exitCode = 1; });预期输出“成功 B”。这里比较的是哪个 Promise 先成功,而不是输入数组的第一个位置。定时器用于演示完成先后,不应把毫秒数当作真实网络服务的响应承诺。

立即学习“Java免费学习笔记(深入)”;
全部失败时,按输入顺序检查 AggregateError.errors
errors 保存每个输入的拒绝原因,顺序与输入一致,而不是实际失败顺序。拒绝原因可以是任意值,并不保证都是 Error;业务日志读取 message 前,应确认自己的任务使用了什么拒绝值。
const assert = require('node:assert/strict');
const failLater = (message, ms) => new Promise((_, reject) => {
setTimeout(() => reject(new Error(message)), ms);
});
(async () => {
await assert.rejects(
Promise.any([failLater('A', 20), failLater('B', 5)]),
error => {
assert.ok(error instanceof AggregateError);
assert.deepEqual(error.errors.map(item => item.message), ['A', 'B']);
return true;
}
);
await assert.rejects(Promise.any([]), error => {
assert.ok(error instanceof AggregateError);
assert.deepEqual(error.errors, []);
return true;
});
console.log('全部失败与空输入检查通过');
})().catch(error => { console.error(error); process.exitCode = 1; });B 虽然先失败,errors 仍按 A、B 排列。空输入也会拒绝,错误列表为空;不要把它理解成返回 undefined 的成功结果。
取得结果后,核对其他任务仍会继续执行
any 不会自动清除定时器,也不会取消网络或计算任务。下面用一个手动控制的 Promise 表示剩余任务,先确定成功结果,再继续完成剩余任务,避免依赖耗时阈值做不稳定测试。
const assert = require('node:assert/strict');
(async () => {
let finish;
let completed = false;
const pending = new Promise(resolve => { finish = resolve; })
.then(value => { completed = true; return value; });
const result = await Promise.any([pending, Promise.resolve('首个成功')]);
assert.equal(result, '首个成功');
assert.equal(completed, false);
finish('剩余任务完成');
assert.equal(await pending, '剩余任务完成');
assert.equal(completed, true);
console.log('结果已确定,剩余任务仍能完成');
})().catch(error => { console.error(error); process.exitCode = 1; });需要取消未使用的 fetch 时,应自行管理 AbortController,并明确哪些请求可取消。Promise 的结果组合与底层任务取消是两件事,any 不会替你处理资源生命周期。


















