JavaScript Mock中验证参数的核心是Jest的mock断言：1. toHaveBeenCalledWith验证某组参数是否被调用过（浅比较）；2. toHaveBeenNthCalledWith验证第n次调用的参数；3. 直接检查mock.calls数组获取完整上下文。
在 JavaScript Mock 模拟中，验证被模拟函数的参数是否正确，核心是利用 Jest（最常用测试框架）提供的 mock 函数断言能力，比如 toHaveBeenCalledWith、toHaveBeenNthCalledWith 或直接检查 mock.calls 数组。
使用 toHaveBeenCalledWith 断言具体调用参数
这是最常用、语义最清晰的方式，用于验证函数是否以**某组参数**被调用过（不区分第几次）：
-
mockFn.mock.calls是二维数组，每个子数组代表一次调用的参数列表，例如[[1, 'a'], [2, 'b']] -
toHaveBeenCalledWith(arg1, arg2, ...)会匹配任意一次调用是否与给定参数全等（浅比较） - 支持对象、数组、正则、甚至自定义匹配器（如
expect.stringContaining）
示例：
const api = { fetchUser: jest.fn() };
fetchData(123); // 内部调用了 api.fetchUser('user-123', { timeout: 5000 });
expect(api.fetchUser).toHaveBeenCalledWith('user-123', { timeout: 5000 });
// ✅ 通过
expect(api.fetchUser).toHaveBeenCalledWith('user-456', expect.any(Object));
// ❌ 不通过（参数不匹配）
验证第 N 次调用的参数：toHaveBeenNthCalledWith
当函数被多次调用，且你关心**特定顺序或某次调用**的参数时，这个断言更精准：
立即学习“Java免费学习笔记（深入）”；
-
toHaveBeenNthCalledWith(n, arg1, arg2, ...)中n从 1 开始计数 - 避免因调用次数多、参数相似导致的误判
示例：
service.process('A'); // → 调用 logger.log('start', 'A')
service.process('B'); // → 调用 logger.log('start', 'B')
expect(logger.log).toHaveBeenNthCalledWith(1, 'start', 'A');
expect(logger.log).toHaveBeenNthCalledWith(2, 'start', 'B');
手动检查 mock.calls 获取完整上下文
当需要做复杂判断（如部分匹配、类型校验、嵌套结构深比较）或调试时，直接读取 mock.calls 更灵活：
-
mockFn.mock.calls[0]是第一次调用的参数数组 -
mockFn.mock.calls.length可验证调用次数 - 配合
expect(...).toEqual(...)或自定义逻辑（如检查对象某个字段）
示例（验证第二个参数对象中 id 字段）：
const [firstCall] = api.update.mock.calls;
expect(firstCall[1]).toHaveProperty('id', 123);
// 或
expect(firstCall[1].id).toBe(123);
注意参数匹配的细节
Jest 默认使用浅相等（Object.is），对对象/数组需谨慎：
- 两个不同引用的对象即使内容相同，
toHaveBeenCalledWith({a:1})也会失败 - 解决方法：用
expect.objectContaining、expect.arrayContaining或expect.any() - 必要时可启用深度匹配：用
expect(actual).toStrictEqual(expected)配合手动提取参数
示例（宽松匹配对象）：
expect(api.send).toHaveBeenCalledWith(
'msg',
expect.objectContaining({ priority: 'high', retry: true })
);
