promise是封装异步状态并支持链式响应的构造器，需传入含resolve/reject的executor函数，then()第二参数不等价于catch()，async/await需try/catch捕获错误，all/allsettled选择取决于容错需求。
Promise 不是“教程式工具”，而是一个解决回调地狱、统一异步处理流程的构造器。它本身不执行异步操作，只是对异步任务的**状态封装与链式响应管理**。
Promise 构造函数怎么写才不会立即报错
必须传入一个执行器函数（executor），且该函数接收 resolve 和 reject 两个参数；漏掉任一参数或传入非函数，会直接抛出 TypeError: Promise resolver undefined is not a function。
常见错误写法：
- 写成
new Promise()（没传函数） - 写成
new Promise(() => {})（没解构resolve/reject，后续无法改变状态） - 在 executor 外部提前调用
resolve()（会报ReferenceError）
正确最小结构：
const p = new Promise((resolve, reject) => {
// 这里放异步逻辑，比如 setTimeout、fetch、fs.readFile 等
setTimeout(() => resolve('done'), 100);
});
then() 和 catch() 的执行时机与链式陷阱
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或第二个参数触发
async/await 是 Promise 语法糖，但错误处理逻辑更严格
await 只能在 async 函数内使用，且它会把 Promise 的 reject 转为同步异常，因此必须用 try/catch 捕获，不能靠外围 .catch()。
ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
典型误用：
- 在非
async函数里写await fetch(...)→SyntaxError: await is only valid in async function - 写
const res = await promise; res.json()却没包try/catch→ 后续res.json()报错会直接 unhandled - 用
await 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() 和 Promise.all() 的实际适用边界
Promise.race() 返回第一个 settled（fulfilled 或 rejected）的结果；常用于超时控制，但要注意：如果首个 Promise 是 reject，整个 race 就失败，哪怕其他还在跑。
Promise.all() 要求全部 fulfilled 才 resolve，任一 reject 就立刻 reject —— 它不是“并行执行”，而是“全成功才继续”。需要容错时，应改用：
-
Promise.allSettled()：返回所有 Promise 的结果数组，每个对象含status（'fulfilled'/'rejected'）和value或reason - 手动 map +
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 本身教科书式的定义。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
