对象属性为异步函数的单元测试分支未覆盖问题排查

这种情况我碰到过好多次——明明所有代码行都被执行到了，但async函数的定义行却显示部分分支未覆盖，核心原因在于async函数的隐式Promise分支没被测试覆盖。

为什么会出现这个问题？ #

async函数本质上会把内部逻辑自动包裹在一个Promise里：当函数正常执行完成时，返回resolved状态的Promise；如果内部抛出异常（不管是显式throw还是异步操作失败），则返回rejected状态的Promise。覆盖率工具会把这两种状态当成两个独立分支，而你的测试只覆盖了resolved的场景，所以那行async (token) => {会显示黄色（分支未完全覆盖）。

怎么解决？ #

你需要补充测试用例，覆盖async函数的reject分支，具体分两种常见场景：

1. 模拟异步请求失败的情况

如果你的Services.test依赖的接口返回错误（比如500状态码），测试函数是否能正确处理这种错误：

it("test rejects when request fails", async () => {
  // 模拟接口返回500错误
  nock(url)
    .get('/test')
    .reply(500, { error: "Internal Server Error" });
  
  // 验证函数会reject，并携带正确的错误信息
  await connector.Services.test(token).should.be.rejectedWith("Internal Server Error");
});

2. 验证参数校验的错误分支（如果有）

如果你的Services.test内部有对token的校验逻辑（比如判断token是否存在、是否合法），那你需要补充参数异常的测试用例：

it("test rejects when token is missing", async () => {
  // 不传token，测试函数的参数校验分支
  await connector.Services.test(null).should.be.rejectedWith("Token is required");
});

总结 #

只要补充了这两类错误场景的测试，就能覆盖async函数的所有分支，消除覆盖率报告里的黄色标记啦。

内容的提问来源于stack exchange，提问作者N Sharma