Promise.withResolvers() 提供结构化 {promise, resolve, reject} 对象，替代易错的手动缓存方案，提升类型安全与跨函数协作能力，适用于事件监听、模块解耦等延迟决议场景。
Promise.withResolvers 提供了一种更直观、更可控的方式来分离 Promise 的创建与决议（resolve/reject），特别适合在多个函数或模块间协作管理异步状态，避免手动封装 resolve 和 reject 回调的冗余逻辑。
替代手动缓存 resolve/reject 的老套路
过去常通过闭包保存 resolve 和 reject，比如：
let pendingResolve, pendingReject;<br>const promise = new Promise((resolve, reject) => {<br> pendingResolve = resolve;<br> pendingReject = reject;<br>});<br>// 后续某处调用 pendingResolve(value)
这种方式易出错：变量命名易冲突、作用域混乱、难以类型推导。而 Promise.withResolvers() 一次性返回结构化对象：
-
{ promise, resolve, reject }—— 三者天然绑定，语义清晰 -
promise可自由传递，resolve/reject可安全暴露给其他函数调用 - TypeScript 下自动获得精准类型（如
Promise<number></number>对应的resolve: (v: number) => void）
跨函数触发异步完成（例如事件响应、回调注入）
常见于监听外部事件后结束等待，比如等待某个 DOM 按钮被点击、WebSocket 收到特定消息：
- 主函数创建
resolvers = Promise.withResolvers()，返回resolvers.promise给调用方 - 另一个函数（如事件处理器）持有
resolvers.resolve，收到条件满足时直接调用 - 无需全局变量或复杂状态机，生命周期由 Promise 自动管理
function waitForClick(buttonId) {<br> const { promise, resolve } = Promise.withResolvers();<br> const handler = () => {<br> button.removeEventListener('click', handler);<br> resolve(); // ✅ 清晰表达“已完成”意图<br> };<br> document.getElementById(buttonId)?.addEventListener('click', handler);<br> return promise;<br>}
解耦异步流程中的“通知者”与“等待者”
适用于微服务通信、插件系统、状态同步等场景：一个模块发起请求并持 promise，另一个模块（甚至不同文件）负责决议。
- 等待方只关心
promise，不依赖具体实现细节 - 通知方只需拿到
resolve函数，无需知道 promise 从哪来、是否已被消费 - 可配合 WeakMap 存储 resolver 实例，按 ID 关联，避免内存泄漏
注意兼容性与使用边界
Promise.withResolvers 是 ECMAScript 2024（ES15）标准特性，目前主流浏览器（Chrome 121+、Firefox 122+、Safari 17.4+）已支持，Node.js 21.2.0+ 原生可用。若需兼容旧环境，可用轻量 polyfill（如 promise-with-resolvers-polyfill）。它不替代 async/await，而是补足其无法覆盖的“延迟决议”需求 —— 当你无法在 Promise 构造器内立即决定结果时，它就是最自然的工具。
