简介
bcoe-test-r 是一个 Node.js 包管理器 npm 中的一个测试框架。它可以让你轻松地测试你的 Node.js 模块和代码。
安装
安装 bcoe-test-r 可以通过 npm 来安装。首先你需要在你的终端（Terminal）运行以下命令：
npm install bcoe-test-r --save-dev
使用教程
bcoe-test-r 的使用非常简单，下面我们将通过一个简单的示例来介绍如何使用它。
编写测试
我们将通过一个简单的加法函数的例子来介绍如何编写测试。
首先，我们需要在我们的项目中创建一个名为 test 的目录，并在其中创建一个名为 add.test.js 的文件。在 add.test.js 中，我们可以使用以下代码来编写我们的测试：
const add = require('../add');
test('adds 1 + 2 to equal 3', () => {
expect(add(1, 2)).toBe(3);
});在这个测试中，我们首先使用 require 来引入我们要测试的模块。然后我们使用 test 函数来定义一个测试，这个测试会接受两个参数：一个描述该测试的字符串，和一个测试函数。在测试函数中，我们使用 expect 函数来断言 add(1, 2) 的返回值应该等于 3。
运行测试
我们在编写完测试之后，就可以使用 bcoe-test-r 来运行我们的测试了。首先我们需要将 bcoe-test-r 添加到项目的 package.json 文件中，如下所示：
{
"scripts": {
"test": "bcoe-test-r"
}
}然后，在终端中运行以下命令即可运行我们的测试：
npm test
这个命令将自动运行我们所有 test 目录中的测试，并在控制台中输出测试结果。
深入分析
bcoe-test-r 的核心思想是断言（assertion）。它提供了一系列的断言函数，让我们可以方便地编写测试。下面我们将介绍一些常用的断言函数，以及如何自定义断言函数。
常用的断言函数
expect
expect 函数用来获取要测试的表达式或值，并在之后可以添加断言函数。
expect(5)
toBe
toBe 函数用来比较两个值是否严格相等。
expect(1 + 2).toBe(3)
toEqual
toEqual 函数用来比较两个值是否值相等。
expect({ a: 1, b: 2 }).toEqual({ a: 1, b: 2 });toMatch
toMatch 函数用来判断一个字符串是否包含指定的字符串或正则表达式。
expect('hello, world').toMatch('hello');expect('hello, world').toMatch(/world/);toContain
toContain 函数用来判断一个数组或类数组对象是否包含指定的元素。
expect([1, 2, 3]).toContain(2);
toBeTruthy
toBeTruthy 函数用来判断一个表达式的值是否为真。
expect(true).toBeTruthy();
toBeFalsy
toBeFalsy 函数用来判断一个表达式的值是否为假。
expect(false).toBeFalsy();
toBeUndefined
toBeUndefined 函数用来判断一个表达式的值是否为 undefined。
expect(undefined).toBeUndefined();
toBeNull
toBeNull 函数用来判断一个表达式的值是否为 null。
expect(null).toBeNull();
toBeNaN
toBeNaN 函数用来判断一个表达式的值是否为 NaN。
expect(NaN).toBeNaN();
自定义断言函数
除了官方提供的断言函数之外，我们还可以自定义断言函数。自定义断言函数可以提高代码的可读性和可维护性。
例如，下面是一个自定义的 toBeWithinRange 函数，用来判断一个数字是否在指定的范围内：
-- -------------------- ---- -------
---------------
------------------------- ------ -------- -
----- ---- - -------- -- ----- -- -------- -- --------
-- ------ -
------ -
-------- -- --
--------- ----------- --- -- -- ------ ----- -------- - ------------
----- -----
--
- ---- -
------ -
-------- -- --
--------- ----------- -- -- ------ ----- -------- - ------------
----- ------
--
-
--
---
------------- -------- -- -- -
------------------------------- -----
---------------------------------- -----
---这个函数通过 expect.extend 来定义一个新的断言函数 toBeWithinRange。然后，在测试用例中我们就可以使用 toBeWithinRange 函数来判断数字是否在范围内了。
总结
bcoe-test-r 是 Node.js 生态中非常好用的测试框架，它提供了丰富的断言函数和自定义能力，让我们可以轻松地编写高质量的测试用例。希望这篇文章能够帮助你更好地掌握 bcoe-test-r 的使用。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6005548a81e8991b448d1cf3