使用Vitest监视多参数函数时，单断言错误致后续断言全失败

原因分析 #

你当前使用的toBeCalledWith（等价于toHaveBeenCalledWith）断言逻辑是验证函数至少存在一次调用使用了指定参数，而非按调用顺序验证某一次的参数。

你遇到的「所有断言失败」的情况，本质是误解了API的行为：当第三次调用传入5而非3时，1、2、4这三个参数的调用依然存在，理论上对应的toBeCalledWith(1)/toBeCalledWith(2)/toBeCalledWith(4)应该通过，但你的错误输出显示的是按顺序对比的差异，说明你实际需求是按调用顺序验证每一次的参数，而当前写法无法实现这个目标。

解决办法 #

Vitest提供了专门的API来按顺序验证第N次调用的参数，或者一次性对比所有调用的参数序列：

方法1：按顺序验证单次调用参数 #

使用toHaveBeenNthCalledWith(n, ...args)断言，其中n是调用的顺序编号（从1开始）：

it('should call mySpiedFunc with expected arguments in order', () => {
  myFunction();

  expect(mySpiedFunc).toHaveBeenNthCalledWith(1, 1);
  expect(mySpiedFunc).toHaveBeenNthCalledWith(2, 2);
  expect(mySpiedFunc).toHaveBeenNthCalledWith(3, 3);
  expect(mySpiedFunc).toHaveBeenNthCalledWith(4, 4);
});

修改后，当第三次调用传入5时，只有第三个断言会失败，其余验证第1、2、4次参数的断言会正常通过，完全符合你的预期。

方法2：一次性验证所有参数序列 #

先验证调用次数，再获取调用历史的参数数组进行整体对比：

it('should call mySpiedFunc with expected arguments in order', () => {
  myFunction();

  // 先确认调用次数符合预期
  expect(mySpiedFunc).toHaveBeenCalledTimes(4);
  // 提取所有调用的第一个参数（适配你的单参数调用场景）
  const actualArgs = mySpiedFunc.mock.calls.map(call => call[0]);
  // 对比参数序列
  expect(actualArgs).toEqual(expectedArgs);
});

这种方式会直接显示完整的参数数组差异，能快速定位错误的位置，适合参数数量较多的场景。

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