概述
在前端开发中，单元测试是一个重要的环节。而其中一个关键的组成部分就是断言库，也就是用来判断测试结果是否符合预期的工具。
在 npm 中，@jamestalmage/empower-assert 是一个非常受欢迎的断言库，它可以让你更方便地编写和阅读测试用例。本文将详细介绍该库的使用方法和注意事项。
安装
npm install @jamestalmage/empower-assert -D
基本用法
-- -------------------- ---- ------- ----- ------------- - ---------------------------------------- -- -- ------------- ----- ----- ------ - --------------------------------- -- ------ ----------- -- -- - -------------------- - -- --- ---
在使用 empowerAssert 包装之后，你就可以像使用普通的 assert 一样使用它了。不过，它还提供了一些额外的功能，接下来我们会详细介绍。
增强输出
使用 empowerAssert，当测试用例失败时，输出信息将比原来更详细。
以一个简单的例子来说明：
describe('A test suite', () => {
it('should fail', () => {
assert.deepEqual([1, 2], [3, 4]);
});
});这里我们故意让测试用例失败。原始输出只会告诉我们哪个测试用例失败了：
AssertionError: expected [ 1, 2 ] to deeply equal [ 3, 4 ]
使用 empowerAssert，输出信息将更加详细，包括了该测试用例的信息、期望值和实际值：
-- -------------------- ---- -------
---------------
-------- - -- - - -- ------ ----- - -- - -
-- -------------------- --- --- ----
-- ---
-- ---
-- --
--------- ---------
--- ------------------ --------------
--------- - -- - -
------- - -- - -其中，第一部分是断言错误的描述，第二部分是代码上下文（包括错误行号），第三部分则是断言的具体信息，包括运算符、错误行号、期望值和实际值等。
这个功能在定位错误时非常有用，可以帮助我们更快地找到问题所在。
支持自定义断言函数
有时候，我们可能需要在测试用例中使用自己定义的断言函数。例如，我们要测试某个函数能否正确地抛出异常：
-- -------------------- ---- -------
-------- ------------ -
----- --- --------------
-
----------- ---- ------- -- -- -
---------- ------- -- -- -
------------------------- ------ --------
---
---使用 empowerAssert，我们同样可以把自定义的断言函数包装进去：
-- -------------------- ---- -------
----- ------ - ---------------------------------
-------- ------------ -
----- --- --------------
-
----------- ---- ------- -- -- -
---------- ------- -- -- -
---------------- -- -------------------------------- ------ --------
---
---注意，这里需要包装一层 assert.doesNotThrow，否则错误信息会变得混乱和难以理解。
支持自定义消息和上下文
在很多情况下，我们都需要在测试用例中添加一些自定义的消息或额外的上下文。例如，我们要测试数组的 push 方法是否正确地改变了长度，同时需要输出一些信息：
describe('A test suite', () => {
it('works', () => {
const arr = [1, 2];
assert.strictEqual(arr.push(3), 3, 'push should return the new length');
assert.strictEqual(arr.length, 3, `arr should have length 3, but actually it's ${arr.length}`);
});
});使用 empowerAssert，我们可以直接在函数调用中传递消息，并在输出信息中看到它：
describe('A test suite', () => {
it('works', () => {
const arr = [1, 2];
assert.strictEqual(arr.push(3), 3, 'push should return the new length');
assert.strictEqual(arr.length, 3, empowerAssert.message`arr should have length 3, but actually it's ${arr.length}`);
});
});empowerAssert.message 是一个模板函数，它可以帮我们将消息和格式化的变量都放到输出信息中。
有时候，我们还需要将一些额外的上下文放到输出信息中。例如，我们要测试字符串的 split 方法是否正确地切分了字符串，但我们想要输出一下整个字符串的内容。
describe('A test suite', () => {
it('works', () => {
const str = 'a,b,c';
const parts = str.split(',');
assert.strictEqual(parts.length, 3, empowerAssert.message`the length of ${str} should be 3, but actually it's ${parts.length}`);
});
});这里我们使用了 empowerAssert.message 和模板字符串，通过 ${str} 将字符串的值嵌入到输出信息中。
结论
@jamestalmage/empower-assert 是一个非常实用和强大的断言库，可以大大提升我们的单元测试效率和质量。
在使用时，需要注意使用享有的增强输出功能和自定义消息和上下文功能，并根据实际情况选择是否使用自定义断言函数。通过这些技巧，我们可以更轻松地编写和维护单元测试用例。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60066bc4967216659e244336