介绍
assert-x 是一个可扩展的 JavaScript 断言库。该库支持自定义断言函数和格式化函数以覆盖默认行为。它还提供了一些支持 JavaScript 和 Node.js 的实用工具函数，如类型检查、比较、机器码验证等。
安装
使用 npm 进行安装：
--- ------- --------
使用
assert-x 非常易用，只需引入即可开始使用。下面是一个简单的示例：
----- ------ - -------------------- -- ----- --------------- ---- ----------- -- ------------ ------------------- -- --- -- ------------- -- ------------ --------------- -- - -- ---- ------------
如果断言失败，assert-x 会抛出 AssertionError。你可以使用 try-catch 块来捕获异常并处理它。
API 文档
下面介绍一些核心函数及其用法。
equal
-------- ------------- ---- --------- ---- --------- -------- -----
测试两个值是否相等。可选参数 message 为失败时的错误信息。
--------------- ---- -----------
deepEqual
-------- ----------------- ---- --------- ---- --------- -------- -----
测试两个值是否深度相等（递归比较对象的属性）。可选参数 message 为失败时的错误信息。
------------------ -- - -- - -- --- -- --------------
throws
-------- ------------- --------- --------- -------- -----
测试函数是否抛出异常。可选参数 message 为失败时的错误信息。
---------------- -- - ----- --- --------------- -- ------------
rejects
-------- ---------------- ------------- --------- -------- --------------
测试 Promise 是否被拒绝。可选参数 message 为失败时的错误信息。该函数返回一个 Promise，在 Promise 被拒绝时解析，否则拒绝。
----- -------- ------ - ----- --------------------------------- ---------------- -------- -------- -
includes
-------- ---------------- ---- ---- -- --------- -------- ----- -------- ------------- ------- ---- ------- --------- -------- -----
测试数组或字符串是否包含指定元素。可选参数 message 为失败时的错误信息。
------------------- -- --- -- ------------- ---------------------- ------- -------- --------------
hasOwn
-------- ----------- ------- ---- ------------ --------- -------- -----
测试对象是否具有指定属性。可选参数 message 为失败时的错误信息。
--------------- -- - -- ---- ------------
is
-------- ------------- -- --------- -- --------- -------- -----
测试两个值是否完全相等（使用严格相等运算符 ===）。可选参数 message 为失败时的错误信息。
------------ -- -------------
扩展
assert-x 使用了一个简单的插件机制，允许用户覆盖默认的断言函数和格式化函数。下面介绍如何编写插件。
插件是一个对象，其属性是插件名称，值为插件函数。插件函数接收一个 assert 对象作为参数，该对象包含所有默认断言函数和格式化函数。插件函数应该修改 assert 对象并返回新的 assert 对象。
----- ------ - -
--------- -------- -- -
-------------- - -------- --------- -------- -- -
-- -----------
-- ------- --- --------- -
----- --- -----------------------
-------- --------------------- -- --------- --------- -- ----- --------------
--------- ---------
------- -------
--------- ---------
---
-
--
------ -------
-
--
----- -------- - --------------------------------------------
----------- ---- ----------- -- -- --------------在上面的例子中，我们定义了一个名为 myAssert 的插件，该插件添加了一个自定义的相等性断言函数 myEqual。该插件被加载到 assert-x 中并返回了新的 myAssert 函数。
结论
assert-x 是一个功能强大的 JavaScript 断言库，它支持自定义断言函数和格式化函数以覆盖默认行为。assert-x 还提供了一些支持 JavaScript 和 Node.js 的实用工具函数，如类型检查、比较、机器码验证等。通过插件机制，你可以轻松定制 assert-x 来满足自己的需求。
来源：JavaScript中文网 ，转载请联系管理员！ 本文地址：https://www.javascriptcn.com/post/78394