Promise核心API共7个最常用接口：实例方法then、catch、finally用于链式处理单个异步流；静态方法all、race、allSettled、resolve/reject用于协调多个Promise或统一返回类型。
Promise 的核心 API 并非严格“九个”，而是由实例方法和静态方法两大类构成，共涵盖 7 个最常用、最具实践价值的接口（then、catch、finally、all、race、allSettled、resolve/reject），其中 resolve 和 reject 常被并列视为基础构造辅助工具。所谓“九个”多为教学归纳或版本差异所致；真正高频、不可替代的是这七项。它们按用途清晰分为两类，每类对应明确的工程场景。
一、实例方法：链式处理单个异步任务流
所有以 .then()、.catch()、.finally() 形式调用的方法，都作用于 Promise 实例本身，用于响应其状态变化。它们是构建可读、可维护异步流程的基石。
-
.then(onFulfilled, onRejected)：首选用于顺序消费成功结果，也可传入第二个参数直接捕获本级错误（但推荐统一用.catch()）。适用于“请求 → 解析 → 渲染”这类线性依赖链。 -
.catch(onRejected)：专用于集中错误兜底。它会捕获前面任意then中抛出的异常或 rejected 状态，并支持错误冒泡——即未被中间catch捕获的错误会一直向后传递，直到遇到首个catch或全局 unhandledrejection。 -
.finally(onFinally)：执行与结果无关的收尾操作，如关闭 loading 动画、释放资源、清空临时状态。它不接收参数，也不影响链中后续的值或状态，纯粹是副作用钩子。
二、静态方法：协调多个 Promise 的并发行为
这些方法挂载在 Promise 构造函数上（如 Promise.all()），用于批量管理一组 Promise，解决多任务协同问题。
-
Promise.all([p1, p2, ...])：适用于强一致性依赖场景，例如表单提交前需同时校验邮箱、手机号、验证码三个接口，全部成功才提交。任一失败即整体 reject，返回第一个失败原因。 -
Promise.race([p1, p2, ...])：适用于竞速型需求，如设置请求超时：Promise.race([fetch(url), timeout(5000)])，谁先 settle 就用谁的结果（成功或失败）。 -
Promise.allSettled([p1, p2, ...])：适用于全量结果收集场景，比如批量上传文件，需知道每个文件是成功还是失败，不因个别失败中断整体统计。返回每个 Promise 的 {status, value/reason} 对象数组。 -
Promise.resolve(value)/Promise.reject(reason)：不是“发起异步”，而是快速包装已有值为 Promise。常用于统一接口返回类型（如函数有时同步返回数据、有时返回 Promise）、适配旧逻辑、或在条件分支中补全 Promise 链（避免then返回非 Promise 导致值穿透）。
三、不推荐单独使用的“伪API”说明
有些资料列出的“九个”可能包含已废弃或极少独立使用的接口：
立即学习“Java免费学习笔记（深入）”；
-
Promise.defer()：从未进入标准，属早期 polyfill 补丁，现代代码无需使用。 -
Promise.prototype.done()：非标准提案，已被弃用，.catch()+ 全局监听已足够。 -
Promise.try()：类似Promise.resolve().then(fn)，可用原生写法替代，无必要引入额外概念。
真正值得投入精力掌握的，就是上述七项。它们覆盖了从单任务流转到多任务编排的全部典型需求，且在现代浏览器和 Node.js 环境中稳定支持多年。
