在前端开发中，我们经常需要进行单元测试和集成测试。为了更方便地进行测试，我们可以使用断言库来检查代码的正确性。在 Node.js 中，我们可以使用 Node.js 预置的 assert 模块，但这个模块的 API 使用起来比较繁琐，不够便捷。因此，我们可以使用第三方的断言库来简化测试代码并提高测试的可读性。
其中一个比较优秀的断言库是 @cgjs/assert，它使用简单，API 易于理解，并且支持主流的测试框架。本文将介绍如何使用 @cgjs/assert 进行单元测试和集成测试。
安装
在使用 @cgjs/assert 之前，你需要先安装它。你可以使用 npm 来安装它，在命令行中输入以下命令：
--- ------- ------------ ----------
使用
引入
在使用 @cgjs/assert 之前，你需要先引入它。在测试代码文件中，你可以使用以下方式引入：
----- ------ - -----------------------
或者，你也可以使用 ES6 的 import 语法引入：
------ ------ ---- --------------
基本用法
在 @cgjs/assert 中，断言的形式是 assert(expression, [message])。其中，expression 是待测试的表达式，可以是任意类型的值；message 是可选的参数，用于自定义错误提示信息。如果表达式的值为 false，那么 assert 函数会抛出 AssertionError 异常，否则不会有任何输出。
下面是一个简单的例子：
----- --- - --- -- -- - - - ------------- -- --- -- -- - - ---- ---
在上面的例子中，我们定义了一个 add 函数，用于计算两个数的和。然后，我们使用 assert 函数来测试 add(2, 3) 是否等于 5，如果不等于就会抛出 AssertionError 异常，并输出自定义错误提示信息。
常用断言
@cgjs/assert 支持基本的断言，包括：
- assert.ok(value, [message])：测试 value 是否为真值。该断言与 assert(value, message) 等价。
- assert.equal(actual, expected, [message])：测试 actual 是否等于 expected。
- assert.notEqual(actual, expected, [message])：测试 actual 是否不等于 expected。
- assert.strictEqual(actual, expected, [message])：测试 actual 是否严格等于 expected。
- assert.notStrictEqual(actual, expected, [message])：测试 actual 是否不严格等于 expected。
- assert.deepEqual(actual, expected, [message])：测试 actual 是否深度等于 expected。
- assert.notDeepEqual(actual, expected, [message])：测试 actual 是否深度不等于 expected。
- assert.throws(fn, [error], [message])：测试 fn 是否会抛出异常。如果指定了 error，那么测试是否抛出指定类型的异常；否则测试是否抛出任意异常。
下面是一个使用了常用断言的例子：
--------------- ----- ------ --------------- ---- --- - ------- --- --------------------- -- --- - -------- --- ------------------ -- - -- - -- --- -- ------- ---------------- -- - ----- --- ------------- -- ---------- ---- ----- ----
定制错误消息
@cgjs/assert 还支持定制错误消息，通过为每个断言指定一个错误消息，你可以更方便地理解测试失败的原因。
----- ------ - ----- ----------------- ------------- -----------
在上面的例子中，我们传递了一个自定义的错误消息，指出了测试失败的原因。这样让测试失败时更容易定位和修复错误。
类型检查
为了防止不同类型的值被当做同类型的值来测试，@cgjs/assert 还支持类型检查，可以确保待测试的值和期望的值的类型一致。
---------------------------- ---------- --------- ---------- ----------
在上面的例子中，我们使用了 typeof 运算符来测试 undefined 的类型，确保它不等于字符串类型。
总结
@cgjs/assert 是一个很好的断言库，它使用简单，API 易于理解，并支持主流的测试框架。通过本文的介绍，你应该已经掌握了 @cgjs/assert 的基本使用方法和常用断言。在编写单元测试和集成测试时，@cgjs/assert 意义重大，它可以提高测试代码的可读性和易用性。如果你还没有使用过它，我强烈建议你尝试一下！
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/60058a6481e8991b448ed384