前言
在前端开发中，我们经常需要写各种测试来确保代码的质量和正确性。例如，我们可能需要测试某个组件是否能正确渲染，或者某个 API 是否返回了正确的结果。在这些测试中，常常需要使用断言来判断测试结果是否符合预期。
然而，原生的断言函数并不足够丰富和友好，难以处理复杂的测试情况，也不够具有可读性。为此，一些第三方的测试框架出现了，其中 Chai 是一个功能强大、易于使用的断言库，它能够让我们更加轻松地写出可读性高的测试代码。
在本文中，我们将介绍 Chai 的使用方法，包括基本用法、断言链、API 扩展以及自定义断言等内容，并通过大量的示例代码帮助读者深入了解和掌握这个优秀的测试库。
基本用法
Chai 主要提供了两种基本的断言风格，分别是 assert 风格和 expect 风格。assert 风格主要基于 Node.js 原生的 assert 模块，常常被用于测试函数的返回值和抛出的错误等情况；而 expect 风格则更加自由和灵活，适合于各种不同的测试场景。我们先来看一下它们的基本用法。
assert 风格
assert 风格主要由一系列的 assert 函数组成，其中最常见的是 assert.equal 和 assert.deepEqual，它们用于判断两个值是否相等。例如：
const assert = require('assert'); assert.equal(1, 1); // pass assert.equal(1, '1'); // fail assert.deepEqual([1, 2, 3], [1, 2, 3]); // pass assert.deepEqual([1, 2, 3], [3, 2, 1]); // fail
除了 assert.equal 和 assert.deepEqual，assert 风格还提供了一系列的其他函数，如 assert.ok、assert.notEqual、assert.strictEqual 等等，它们的作用各不相同。
expect 风格
expect 风格则更加灵活和直观，它的调用链通常以 expect 函数开始，紧接着是某个值，然后使用 to 或 not.to 作为连接字，进而链式调用其他断言函数。例如：
const expect = require('chai').expect; expect(1).to.equal(1); expect(1).to.not.equal('1'); expect([1, 2, 3]).to.deep.equal([1, 2, 3]); expect([1, 2, 3]).to.not.deep.equal([3, 2, 1]);
除了 to 和 not.to，expect 还提供了一些其他的连接字，如 to.be、to.have、to.include、to.throw 等等，可以根据具体的测试需要进行选择。
断言链
Chai 的灵活之处在于其支持链式调用一系列的断言函数，使得测试代码更加简洁和清晰。例如，我们可以通过链式调用 expect(a).to.be.above(1).and.below(10)，来同时测试 a 是否大于 1 且小于 10。如果其中任意一个条件不符合，测试都将失败。
除了上述的 and 连接字，Chai 还支持 or 连接字，用于在多个条件之间进行或的比较。例如，expect(a).to.be.above(1).or.below(-1) 表示 a 是否大于 1 或者小于 -1。
API 扩展
除了原有的 assert 和 expect 风格，Chai 还支持 API 扩展，允许开发人员自定义一些断言函数，以方便针对特定的测试情况进行判断。API 扩展分为两种类型，分别是断言类型和插件类型。
断言类型
断言类型可以通过 Assertion.addMethod(namespace, method) 函数来注册，其中 namespace 是命名空间，method 是需要注册的函数。例如，我们可以实现一个自定义的字符串包含函数：
-- -------------------- ---- ------- ----- ------ - ----------------------- -------------- -------------------------- ------------------------------------------ ---------- - ----- ------ - ---------- ------------ ----------------------- --------- - - ------ - - -- ------- - ------- --------- - - ------ - - --- -- ------- - ------ -- ---展开代码
在上面的例子中，我们使用 expect().to.containVowel() 来测试字符串是否包含元音字母。如果测试失败，会输出相应的错误信息。
插件类型
插件类型是 Chai 更加高级的扩展机制，它允许我们为 Chai 添加更加复杂和灵活的功能。插件通常由一个或多个新的断言类型组成，可以包含各种设置、钩子函数和其他需要的内容。我们可以通过 chai.use(plugin) 函数来加载插件，例如：
const plugin = require('chai-plugin'); chai.use(plugin); expect(a).to.be.example(); // 使用插件中的自定义断言函数
在上面的例子中，我们加载了名为 chai-plugin 的插件，并使用了其中提供的自定义断言函数。
自定义断言
除了 API 扩展，Chai 还允许开发人员自定义断言函数，以满足特定的测试需求。自定义断言函数的实现很简单，只需要返回一个对象，其中包含了 validate 和 showErrorMessage 两个函数。validate 函数会接受实际的值并返回一个布尔值，表示测试是否通过；showErrorMessage 函数则会返回一个字符串，表示测试失败时的错误信息。例如：
-- -------------------- ---- ------- ----- ------ - ----------------------- -------------------------- ------------------------------------- -------- -- - ------------ ---------------------------- --------- - - --------- - - -- -- -- --------- --------- - - --------- - - --- -- -- -- -------- -- ---展开代码
在上面的例子中，我们使用 expect().to.be.integer() 来测试一个值是否为整数。如果测试失败，会输出相应的错误信息。
结语
Chai 是一个功能强大、易于使用的断言库，可以让我们更加轻松地写出可读性高的测试代码。本文介绍了 Chai 的基本用法、断言链、API 扩展以及自定义断言等内容，希望能够帮助读者深入了解和掌握这个优秀的测试库，从而更加高效地进行前端开发。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/67b69828306f20b3a62a75a7
