在前端开发中，使用断言库是非常常见的一种做法，能够大大提高代码的可靠性和稳定性。而 Chai.js 作为目前比较流行的 JavaScript 断言库之一，提供了一系列断言方法，用于测试 JavaScript 代码的正确性。其中，Chai.expect.includedIn 方法可以用来断言被测对象是否包含在指定的集合中，本文就来详细讲解一下这个方法。
Chai.expect.includedIn 方法的使用
Chai.expect.includedIn 方法是 Chai.js 中的十分常用的断言方法之一，它的作用是用来断言被测对象是否包含在指定的集合中。这个方法接受两个参数：一个是被测对象，一个是包含集合。下面是 Chai.expect.includedIn 方法的 API 参考：
expect(obj: any, set: Array|String): Assertion;
其中，obj 表示要进行判断的被测对象，set 是一个数组或字符串，表示被测对象应该包含在其中。该方法返回一个断言对象 Assertion，用于进一步进行断言。
使用该断言方法的语法格式如下所示：
expect(obj).to.be.includedIn(set);
其中，obj 表示被测对象，set 表示包含集合。如果 obj 包含在 set 中，则该断言会通过测试，否则测试将会失败。
接下来，我们来通过一些示例代码来更加详细地说明该方法的使用方式和注意事项。
Chai.expect.includedIn 方法的示例代码
下面我们通过一些实例代码演示 Chai.expect.includedIn 方法的使用方式和注意事项。
示例1：测试数字是否包含在集合中
首先，我们来测试一个数字是否包含在一个数组集合中：
-- -------------------- ---- -------
----- ------ - -----------------------
-------------- ---------------------- -------- -- -- -
---------- ------ ---- ---- - -- -------- -- --------- -- -- -
------------------------------------
---
---------- ------ ----- ---- - -- --- -------- -- --------- -- -- -
----------------------------------------
---
---上述代码中，我们在 describe 函数中定义了两个 it 函数块，用于测试数字是否包含在一个数组集合中。第一个 it 函数块会断言 2 是否被包含在 [1,2,3] 中，由于 2 确实在数组中存在，所以该测试通过了；第二个 it 函数块会断言 4 是否被包含在 [1,2,3] 中，由于 4 不在数组中，所以该测试不通过。
示例2：测试字符串是否包含在集合中
接下来，我们来测试一个字符串是否包含在一个字符串集合中：
-- -------------------- ---- -------
-------------- ---------------------- -------- -- -- -
---------- ------ ---- ---- ------- -- -------- -- ------ -------- -- -- -
--------------------------------------- --------
---
---------- ------ ----- ---- ----- -- --- -------- -- ------ -------- -- -- -
----------------------------------------- --------
---
---上述代码中，我们在 describe 函数中定义了两个 it 函数块，用于测试字符串是否包含在一个字符串集合中。第一个 it 函数块会断言 "world" 是否被包含在 "hello world" 中，由于它确实被包含在其中，因此该测试通过了；第二个 it 函数块会断言 "foo" 是否被包含在 "hello world" 中，由于它不在其中，所以该测试通过了。
示例3：测试特殊情况
最后，我们还可以测试一些特殊情况，例如 null、undefined 等情况：
-- -------------------- ---- -------
-------------- ---------------------- -------- -- -- -
---------- ------ ----- ---- ---- -- --- -------- -- --------- -- -- -
-------------------------------------------
---
---------- ------ ----- ---- --------- -- --- -------- -- --------- -- -- -
------------------------------------------------
---
---上述代码中，我们在 describe 函数中定义了两个 it 函数块，用于测试 null 和 undefined 是否被包含在一个数组集合中。由于它们都不是有效的数组元素，因此这两个测试都通过了。
总结
本文对 Chai.expect.includedIn 方法的基本语法、参数用法、测试场景做了详细的介绍，希望读者可以通过本文理解和掌握该方法的使用技巧。在实际开发中，我们可以根据实际场景灵活运用该方法，提高代码的可靠性和稳定性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6467109f968c7c53b0778560