Promise是封装异步状态并支持链式响应的构造器,需传入含resolve/reject的executor函数,then()第二参数不等价于catch(),async/await需try/catch捕获错误,all/allSettled选择取决于容错需求。
Promise 不是“教程式工具”,而是一个解决回调地狱、统一异步处理流程的构造器。它本身不执行异步操作,只是对异步任务的**状态封装与链式响应管理**。
必须传入一个执行器函数(executor),且该函数接收 resolve 和 reject 两个参数;漏掉任一参数或传入非函数,会直接抛出 TypeError: Promise resolver undefined is not a function。
常见错误写法:
new Promise()(没传函数)new Promise(() => {})(没解构 resolve/reject,后续无法改变状态)resolve()(会报 ReferenceError)正确最小结构:
const p = new Promise((resolve, reject) => {
// 这里放异步逻辑,比如 setTimeout、fetch、fs.readFile 等
setTimeout(() => resolve('done'), 100);
});
then() 接收两个可选函数:onFulfilled(成功)、onRejected(失败);但**第二个参数不等价于 catch()**——它只捕获前一个 Promise 的拒绝,且一旦被处理,后续 catch() 就收不到这个错误。
容易踩的坑:
p.then(fn).catch(fn):能捕获 fn 内部抛出的错误,也能捕获 p 拒绝p.then(fn, errFn):只捕获 p 拒绝,fn 抛错会跳过 errFn,直接进后续 catch()
then() 返回新 Promise,返回值决定下一级状态:返回普通值 → 下一级 then 收到 fulfilled;抛错或返回被拒 Promise → 下一级 catch 或第二个参数触发await 只能在 async 函数内使用,且它会把 Promise 的 reject 转为同步异常,因此必须用 try/catch 捕获,不能靠外围 .catch()。
典型误用:
async 函数里写 await fetch(...) → SyntaxError: await is only valid in async function
const res = await promise; res.json() 却没包 try/catch → 后续 res.json() 报错会直接 unhandledawait Promise.all([p1, p2]) 时,任一失败就整个 rejected;想忽略单个失败,得先用 Promise.allSettled 或手动包装安全写法示例:
async function loadData() {
try {
const res = await fetch('/api/data');
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return await res.json();
} catch (err) {
console.error('Load failed:', 
err);
throw err; // 显式 re-throw 才能让调用方感知
}
}
Promise.race() 返回第一个 settled(fulfilled 或 rejected)的结果;常用于超时控制,但要注意:如果首个 Promise 是 reject,整个 race 就失败,哪怕其他还在跑。
Promise.all() 要求全部 fulfilled 才 resolve,任一 reject 就立刻 reject —— 它不是“并行执行”,而是“全成功才继续”。需要容错时,应改用:
Promise.allSettled():返回所有 Promise 的结果数组,每个对象含 status('fulfilled'/'rejected')和 value 或 reason
catch 包装:如 promises.map(p => p.catch(e => ({ error: e })))
超时控制示例(避免请求卡死):
function timeout(p, ms) {
return Promise.race([
p,
new Promise((_, reject) =>
setTimeout(() => reject(new Error('Timeout')), ms)
)
]);
}
timeout(fetch('/slow'), 3000).catch(console.error);
真正难的不是写对 Promise 语法,而是判断该用 all 还是 allSettled,该在 then 里 throw 还是 return Promise.reject(),以及是否让错误穿透到最外层——这些取决于业务对失败的容忍粒度,而不是 Promise 本身教科书式的定义。