如何在 Jest 中对同一值进行多条件断言而不重复引用实例-js教程-PHP中文网

如何在 Jest 中对同一值进行多条件断言而不重复引用实例

Jest 默认不支持链式调用多个断言方法，本文介绍几种优雅方案（如 expect.extend 自定义匹配器、jest-extended 扩展库及组合式断言技巧），实现在不声明中间变量的前提下，对单次调用结果执行类型、属性、结构等多重验证。

jest 默认不支持链式调用多个断言方法，本文介绍几种优雅方案（如 `expect.extend` 自定义匹配器、`jest-extended` 扩展库及组合式断言技巧），实现在不声明中间变量的前提下，对单次调用结果执行类型、属性、结构等多重验证。

在编写单元测试时，我们常希望对一个函数的返回值同时验证多个方面：是否为某类实例、是否具备特定属性、属性值是否符合预期等。但 Jest 的原生 expect() 断言方法（如 .toEqual()、.toHaveProperty()）均返回 undefined，无法链式调用——这导致我们不得不引入临时变量（如 const result = ...），既增加认知负担，又略显冗余。

✅ 推荐方案一：使用 jest-extended（最简洁实用）

jest-extended 是社区广泛采用的 Jest 扩展库，提供了丰富且语义清晰的匹配器，其中 .toSatisfyAll() 和组合式断言可完美解决该问题：

npm install --save-dev jest-extended

并在 Jest 配置中启用（如 setupFilesAfterEnv）：

// jest.setup.js
require('jest-extended');

然后即可写出高可读性的一行多断言：

describe('Test.makeTest', () => {
  it('returns a valid Test instance with merged config', () => {
    const testInstance = Test.makeTest({ a: 1, b: 2 });

    expect(testInstance).toSatisfyAll([
      (v) => expect(v).toBeInstanceOf(Test),
      (v) => expect(v).toHaveProperty('id', 0),
      (v) => expect(v).toHaveProperty('config', expect.objectContaining({ a: 1, b: 2 })),
    ]);
  });
});

? toSatisfyAll 接收断言函数数组，每个函数接收被测值并执行独立 expect；任一失败即中断并输出清晰错误信息。

✅ 推荐方案二：自定义链式匹配器（轻量可控）

若不想引入第三方依赖，可利用 Jest 的 expect.extend() 创建支持链式的匹配器：

// jest.setup.js
expect.extend({
  toHaveValidTestShape(received) {
    const pass =
      received instanceof Test &&
      typeof received.id === 'number' &&
      typeof received.config === 'object' &&
      received.config !== null;

    if (pass) {
      return {
        message: () => `expected ${received} not to be a valid Test instance shape`,
        pass: true,
      };
    } else {
      return {
        message: () => `expected ${received} to be a valid Test instance shape`,
        pass: false,
      };
    }
  },
});

配合 expect.objectContaining 等原生匹配器，仍需分步写，但可封装复合逻辑：

it('works in simple case', () => {
  const instance = Test.makeTest({ a: 1, b: 2 });

  expect(instance).toHaveValidTestShape();
  expect(instance.config).toEqual(expect.objectContaining({ a: 1, b: 2 }));
  expect(instance.id).toBe(0);
});

虽未完全消除变量，但显著提升了语义表达力与复用性。

⚠️ 注意事项与最佳实践

避免过度链式追求：Jest 设计哲学强调“一个 expect 对应一个明确断言”。强行链式可能掩盖真实失败点（如第一个断言失败后后续不执行）。toSatisfyAll 本质仍是顺序执行，但错误提示更友好。
ID 副作用需隔离：示例中 Test.id++ 是全局状态，测试间易相互干扰。建议在 beforeEach 中重置静态属性：
```
beforeEach(() => {
  Test.id = 0;
});
```
优先使用语义化匹配器：例如 toBeInstanceOf(Test) 比 toEqual(expect.any(Test)) 更准确、报错更清晰；toHaveProperty('config', {...}) 比手动 expect(instance.config).toEqual({...}) 更具上下文感知。