前端开发中常用的 npm 包之 @coderbyheart/jest-expect-tobewithin

前言

在前端开发中，单元测试是非常重要的环节，而 Jest 是一种非常流行的 JavaScript 测试框架。在使用 Jest 进行测试时，我们经常需要对测试结果进行断言，而 Jest 默认提供的 expect 断言方法不能满足所有的需求，很多时候我们需要自定义一些断言方法来方便测试。而 @coderbyheart/jest-expect-tobewithin 就是一种非常实用的自定义断言方法。

提供的功能

@coderbyheart/jest-expect-tobewithin 提供了一个 toBeWithin 断言方法，可以判断一个数值是否在某个范围内，可以很方便地进行测试。

安装

安装方式很简单，在项目根目录下使用 npm 命令进行安装就好了。

npm install @coderbyheart/jest-expect-tobewithin --save-dev

使用

在进行 Jest 测试时，首先需要 import @coderbyheart/jest-expect-tobewithin：

const { toBeWithin } = require('@coderbyheart/jest-expect-tobewithin');
expect.extend({ toBeWithin });

然后就可以在测试中使用 toBeWithin 方法了：

test('value is within range', () => {
  expect(10).toBeWithin(5, 15);
});

test('value is not within range', () => {
  expect(20).not.toBeWithin(5, 15);
});

在上面的例子中，第一个测试用例会通过，因为 10 在范围 [5, 15] 内；而第二个测试用例会失败，因为 20 不在范围 [5, 15] 内。

实例解析

下面我们来看一个实际的例子：

test('current date should be within range', () => {
  const currentDate = Date.now();
  const minDate = currentDate - 86400000;
  const maxDate = currentDate + 86400000;
  expect(currentDate).toBeWithin(minDate, maxDate);
});

在这个例子中，我们首先获取当前时间的时间戳，然后计算出前一天和后一天的时间戳作为范围。

最后使用 toBeWithin 方法来判断当前时间是否在范围内。

这样我们就可以方便地进行时间相关的测试了。

总结

@coderbyheart/jest-expect-tobewithin 是一个非常实用的自定义 Jest 断言方法。在进行单元测试时，如果需要断言某个值是否在某个范围内，可以使用该方法来完成，非常方便。希望读者在学习 Jest 测试框架时，能够认真研究并使用到此 npm 包。

来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/600568d781e8991b448e4986