jest-expect 是一个能够帮助我们更轻松地进行测试的 npm 包。它提供了一系列方便好用的 API，以及一些常见的断言，用于验证我们的代码是否符合预期。在本篇文章中，我们将介绍 jest-expect 的使用教程，并通过示例代码来深入探讨其指导意义。
安装 jest-expect
在我们开始使用 jest-expect 之前，需要先安装它。我们可以通过 npm 来安装：
--- ------- ----------- ----------
安装完成之后，将该库引入到我们的测试文件中：
----- ------ - -----------------------
使用 jest-expect 进行测试
接下来，我们就可以使用 jest-expect 来进行测试了。比如说，我们有一个函数，它可以将传入的字符串转换为大写字母：
-------- ---------------- -
-- ------- --- --- --------- -
----- --- ------------------- ---- -- - ----------
-
------ ------------------
-我们希望能够测试该函数是否正常运行，以及是否能够正确处理输入错误等情况。此时，我们可以使用 jest-expect 提供的一些 API 来进行断言：
expect(value)
expect(value) 是 jest-expect 中最基础的 API，用于期望一个值是否符合预期。比如说，我们希望能够期望函数 toUpperCase 的返回值为大写字母的字符串：
----------------- ------ ------ --------- -------- -- -- - ------------------------------------------- ---
toBe() 是 jest-expect 中一个非常实用的 API，用于期望两个值是否相等。我们可以通过该 API 进行如下的各种判断：
-- ------------ ------------------------ ------------------------ -- ----------- -------------------- -- ---------- -------------------------- -- ---------- -------------------------- -- -------------------------- ------------- --------------------------- ---------- -- ----------------- -------- ---- ------ ---- -- -------------------- -- --------------------------- ----------------------------- --- ---------- ---------- -- --------------- --------------------
除了 toBe()，上述示例中列举的 API 都是专门用于某些特定场景下的断言。它们与 toBe() 的区别在于，toBe() 可以用于比较大多数的值，而其他 API 则只能用于特定类型或特定情况下的值。
expect.assertions(n)
expect.assertions(n) 是 jest-expect 中一个很有用的 API，用于验证测试中是否完成了预期的断言数量。比如说，我们希望测试函数 toUpperCase 是否能够正确处理非字符串参数：
----------------- ------ ----- - --------- -- -------- -- --- - -------- -- -- - --------------------- --------- -- ------------------------------------ ---
在上述示例中，我们使用了 toThrow() API 来期望函数 toUpperCase 在传入非字符串参数时会抛出异常。同时，我们使用了 expect.assertions(1) 来期望该测试至少会进行 1 次断言。这是非常重要的，因为如果断言数量不正确，就意味着我们可能没有测试到某些代码分支，从而无法保证代码的完整性和可靠性。
expect.anything()
expect.anything() 是 jest-expect 中一个用于检查值是否不为空的 API。比如说，我们希望测试函数 toUpperCase 是否会返回一个有效的字符串：
----------------- ------ ------ -------- ------ --------- -- ------ -- -- - ------------------------------------------------- -------------------------------------------- --------------------------------------- -- --- --------- -- ---------------------------------------------- -- --- --------- -- --------------------------------------------------- -- --- --------- -- ---
在上述示例中，我们使用了 not.toBeUndefined() 和 not.toBeNull() 来期望函数 toUpperCase 的返回值不为空。另外，我们还使用了 expect.anything()，它可以用于期望任何非空值：
----------------- ------ ------ -------- ------ --------- -- ------ -- -- - -------------------------------------------------------- -------------------------------------------------------- ---
总结
在本篇文章中，我们介绍了 jest-expect 的使用教程，并深入探讨了其指导意义。通过使用 jest-expect 提供的一系列 API，我们可以轻松地进行测试，从而保证代码的完整性和可靠性。使用这些 API 可以让我们更加方便地进行测试，也可以让我们的代码更加规范和易于维护。值得一提的是，在实际的开发过程中，我们也可以根据实际情况以及业务需求，来编写自己的测试用例，以确保代码的正确性和可靠性。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/5eedcc7bb5cbfe1ea06127c1