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