JavaScript异步测试中未捕获的Promise异常会导致静默失败，需监听unhandledrejection事件并显式抛出错误，同时确保async测试正确await或catch，被测代码也应完整处理Promise链。

JavaScript 中异步测试里未捕获的 Promise 异常容易导致测试“静默失败”——看似通过，实则有错误被吞掉。关键在于：Promise 拒绝（reject）若没被 catch 或 await 后处理，会触发全局 unhandledrejection 事件，而多数测试框架默认不将其视为失败。

监听 unhandledrejection 并让测试失败

在测试入口（如 Jest 的 setupFilesAfterEnv、Vitest 的 setupFiles 或 Mocha 的 before 钩子）中添加全局监听器，把未处理的拒绝转为显式错误：

• Jest 示例（jest.setup.js）：
  

  process.on("unhandledRejection", (reason) => {<br>  throw reason;<br>});

• Vitest 示例（vitest.setup.js）：
  

  globalThis.addEventListener("unhandledrejection", (e) => {<br>  throw e.reason;<br>});

• 注意：Jest v29+ 默认已启用该行为（需确保 jest.config.js 中 errorOnUnhandledRejection: true，默认为 true）；Vitest 默认也开启，但建议显式确认。

确保每个 async 测试都正确 await 或 catch

常见疏漏是写了 async test() 却忘了 await 被测函数，或漏掉内部 Promise 链的错误处理：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• ❌ 错误写法（Promise 被创建但未等待）：
  

  test("should fetch user", async () => {<br>  fetchUser(); // 忘了 await → 拒绝不会被当前 test 捕获<br>});

• ✅ 正确写法：
  

  test("should fetch user", async () => {<br>  await fetchUser(); // 确保等待<br>});

• 如果测试本身不 await，又不想让异常冒泡，可主动 catch 并断言：
  await expect(fetchUser()).rejects.toThrow("Network error");

检查被测代码中的 Promise 链是否完整

即使测试写对了，被测函数若存在“忘记 catch”的 Promise，异常仍会逸出：

立即学习“Java免费学习笔记（深入）”；

• ❌ 危险模式（.then 后没 .catch，且没 return 新 Promise）：
  

  function risky() {<br>  fetch("/api").then(res => res.json()); // 没 catch，JSON 解析失败就成 unhandled rejection<br>}

• ✅ 推荐写法（显式处理所有分支）：
  

  async function safe() {<br>  const res = await fetch("/api");<br>  return res.json(); // await 会自动抛出异常，由调用方处理<br>}

  
  或使用 .catch 显式兜底（适合需降级逻辑的场景）。

利用工具辅助检测

静态检查和运行时工具能提前暴露隐患：

• ESLint 插件：eslint-plugin-promise 的 avoid-new-and-return 和 no-promise-without-wait（需自定义规则或配合 eslint-plugin-jest）可提示未处理的 Promise。
• Node.js 命令行参数：node --unhandled-rejections=strict 可强制进程退出（适合 CI 环境）。
• 在测试命令中加 --detectOpenHandles（Jest）或 --leakage（Vitest），有助于发现未清理的定时器或 pending Promise。