Jest框架中的自定义测试匹配器

在 Jest 框架中，你可以创建自定义测试匹配器来满足特定的测试需求

1. 首先，在项目根目录下创建一个名为 customMatchers.ts（或 .js）的文件。这将包含我们的自定义测试匹配器实现。

2. 在 customMatchers.ts 文件中，编写一个自定义测试匹配器函数。例如，我们可以创建一个名为 toBeWithinRange 的匹配器，用于检查一个值是否在指定范围内：

// customMatchers.ts
import { matcherHint, printExpected, printReceived } from 'jest-matcher-utils';

const toBeWithinRange = (received: number, floor: number, ceiling: number) => {
  const pass = received >= floor && received <= ceiling;

  const message = pass
    ? () =>
        `${matcherHint('.not.toBeWithinRange')}\n\n` +
        `Expected value not to be within range:\n` +
        `  floor: ${printExpected(floor)}\n` +
        `  ceiling: ${printExpected(ceiling)}\n` +
        `Received:\n` +
        `  ${printReceived(received)}`
    : () =>
        `${matcherHint('.toBeWithinRange')}\n\n` +
        `Expected value to be within range:\n` +
        `  floor: ${printExpected(floor)}\n` +
        `  ceiling: ${printExpected(ceiling)}\n` +
        `Received:\n` +
        `  ${printReceived(received)}`;

  return { message, pass };
};

3. 接下来，我们需要将自定义测试匹配器添加到 Jest 的全局 expect 对象中。在项目根目录下创建一个名为 setupTests.ts（或 .js）的文件，并添加以下内容：

// setupTests.ts
import { toBeWithinRange } from './customMatchers';

expect.extend({
  toBeWithinRange,
});

4. 确保在 jest.config.js 文件中引用了 setupTests.ts 文件。如果你没有这个文件，请创建一个并添加以下内容：

// jest.config.js
module.exports = {
  // ...其他配置
  setupFilesAfterEnv: ['./setupTests.ts'],
};

5. 现在，你可以在测试文件中使用自定义的 toBeWithinRange 匹配器：

// myComponent.test.ts
import React from 'react';
import { render, screen } from '@testing-library/react';
import MyComponent from './MyComponent';

test('renders the correct value', () => {
  render(<MyComponent />);
  const valueElement = screen.getByText(/Value: /i);
  const value = parseInt(valueElement.textContent.split(' ')[1], 10);

  expect(value).toBeWithinRange(1, 100);
});

在这个示例中，我们创建了一个名为 toBeWithinRange 的自定义测试匹配器，用于检查一个值是否在指定范围内。然后，我们在 setupTests.ts 文件中将其添加到 Jest 的全局 expect 对象中，并在测试文件中使用它。