Jest 测试框架如何进行断言？

在前端开发中，我们经常需要进行单元测试和集成测试，以保证代码质量和功能正确性。而在测试过程中，断言是非常重要的一环，它用于验证代码的行为是否符合预期。

Jest 是前端领域常用的测试框架之一，它提供了丰富的 API 和插件，使得我们可以轻松地编写测试用例和进行断言。

下面我们来详细介绍 Jest 的断言功能。

基本断言

Jest 提供了一系列基本的断言方法，用于判断测试数据是否等于预期的值。以下是一些常用的基本断言：

// javascriptcn.com 代码示例
test('basic assertions', () => {
  // 比较两个值是否完全相等
  expect(2 + 2).toBe(4);

  // 比较两个值是否近似相等，解决 JavaScript 浮点数精度问题
  expect(0.1 + 0.2).toBeCloseTo(0.3);

  // 判断一个值是否为真
  expect(true).toBeTruthy();

  // 判断一个值是否为假
  expect(false).toBeFalsy();

  // 判断值是否为 null
  expect(null).toBeNull();

  // 判断值是否为 undefined
  expect(undefined).toBeUndefined();

  // 判断一个值是否包含在数组中
  expect([1, 2, 3]).toContain(2);

  // 判断一个字符串是否包含一段子字符串
  expect('hello world').toContain('world');

  // 判断一个对象是否含有某个属性
  expect({ name: 'jack', age: 18 }).toHaveProperty('age');
});

异步断言

在实际开发中，我们经常需要进行异步测试，比如测试 AJAX 请求或者定时器回调函数等。这时候，我们需要使用 Jest 提供的异步断言方法。

Jest 支持多种异步测试场景，比如使用回调函数、Promise、async/await 等方式。以下是一些常用的异步断言方法：

// javascriptcn.com 代码示例
test('async assertions', async () => {
  // 测试 Promise 异步操作
  await expect(Promise.resolve(2 + 2)).resolves.toBe(4);

  // 测试 Promise 异常情况
  await expect(Promise.reject('error')).rejects.toBe('error');

  // 测试回调函数异步操作
  function fetchData(callback) {
    setTimeout(() => {
      callback('data');
    }, 1000);
  }
  await expect(new Promise(resolve => fetchData(resolve))).resolves.toBe('data');

  // 测试定时器异步操作
  jest.useFakeTimers();
  setTimeout(() => {
    expect(1 + 2).toBe(3);
  }, 1000);
  jest.runAllTimers();
});

定制断言

除了基本断言和异步断言，Jest 还允许我们编写自定义的断言方法，以满足特定的测试需求。

我们可以在 Jest 的 config 文件中定义一个 globalSetup 函数，用于注册全局断言方法：

// jest.config.js
globalSetup: './tests/globalSetup.js'

在 globalSetup.js 文件中，我们可以使用 expect.extend() 方法来扩展 Jest 断言库。例如，我们可以实现一个 toBeWithinRange 的断言方法，判断一个值是否在指定的范围内：

// javascriptcn.com 代码示例
// globalSetup.js
expect.extend({
  toBeWithinRange(received, floor, ceiling) {
    const pass = received >= floor && received <= ceiling;
    if (pass) {
      return {
        message: () => `expected ${received} not to be within range ${floor} - ${ceiling}`,
        pass: true,
      };
    } else {
      return {
        message: () => `expected ${received} to be within range ${floor} - ${ceiling}`,
        pass: false,
      };
    }
  },
});

这样，我们就可以在测试代码中使用自定义断言了：

test('custom assertions', () => {
  // 测试自定义断言
  expect(100).toBeWithinRange(0, 200);
});

总结

Jest 是一个非常强大的测试框架，它提供了许多方便的断言方法，同时也支持自定义断言。

在编写测试代码时，我们应该充分利用 Jest 的断言功能，确保测试代码能够覆盖到应有的场景，并且能够准确地验证代码行为是否符合预期。

来源：JavaScript中文网 ，转载请注明来源 本文地址：https://www.javascriptcn.com/post/653f41b87d4982a6eb8c983a