Assert 模块

Assert 模块提供了一组用于编写测试和验证代码正确性的断言函数。当断言失败时，会抛出错误，帮助开发者快速定位问题。

功能特性

✅ 基本断言 - 验证条件是否为真

🔍 深度相等比较 - 递归比较对象和数组

🎯 严格相等比较 - 使用 === 语义

🔬 SameValue 比较 - 使用 Object.is() 语义

🚨 异常检测 - 验证函数是否抛出错误

⚠️ 错误处理 - 检查和处理错误值

💥 强制失败 - 显式触发断言失败

API 参考

assert.assert(value, message)

基本断言函数，验证值是否为真（truthy）。

参数：

value - 要测试的值

message (可选) - 失败时的错误消息

示例：

assert.deepEqual(actual, expected, message)

深度相等比较，递归比较对象的所有属性和数组的所有元素。

参数：

actual - 实际值

expected - 期望值

message (可选) - 失败时的错误消息

示例：

assert.notDeepEqual(actual, expected, message)

深度不等比较，验证两个值不是深度相等的。

参数：

actual - 实际值

expected - 期望不相等的值

message (可选) - 失败时的错误消息

示例：

assert.strictEqual(actual, expected, message)

严格相等比较，使用 === 运算符的语义。不会进行类型转换。

参数：

actual - 实际值

expected - 期望值

message (可选) - 失败时的错误消息

示例：

assert.notStrictEqual(actual, expected, message)

严格不等比较，验证两个值不是严格相等的。

参数：

actual - 实际值

expected - 期望不相等的值

message (可选) - 失败时的错误消息

示例：

assert.sameValue(actual, expected, message)

SameValue 比较，使用 Object.is() 的语义。与严格相等类似，但对 NaN 和 -0/+0 的处理不同。

参数：

actual - 实际值

expected - 期望值

message (可选) - 失败时的错误消息

特殊行为：

NaN 等于 NaN（与 === 不同）

-0 不等于 +0（与 === 不同）

示例：

assert.notSameValue(actual, expected, message)

SameValue 不等比较，验证两个值不是 SameValue 相等的。

参数：

actual - 实际值

expected - 期望不相等的值

message (可选) - 失败时的错误消息

示例：

assert.throws(fn, message)

验证函数执行时会抛出错误。

参数：

fn - 要执行的函数

message (可选) - 失败时的错误消息

示例：

assert.doesNotThrow(fn, message)

验证函数执行时不会抛出错误。

参数：

fn - 要执行的函数

message (可选) - 失败时的错误消息

示例：

assert.ifError(value)

如果 value 是真值（truthy），则抛出该值。通常用于回调函数中检查错误。

参数：

value - 要检查的值（通常是错误对象）

示例：

assert.fail(message)

无条件抛出断言失败错误。

参数：

message (可选) - 错误消息，默认为 "Assertion failed"

示例：

使用示例

基本测试

对象和数组测试

异常处理测试

特殊值测试

完整测试套件

比较方法选择指南

何时使用 `assert.assert()`

验证简单的真/假条件

检查对象是否存在

验证布尔表达式

何时使用 `assert.strictEqual()`

比较原始值（数字、字符串、布尔值）

需要类型安全的比较

不想进行类型转换

何时使用 `assert.deepEqual()`

比较对象的内容

比较数组的元素

需要递归比较嵌套结构

何时使用 `assert.sameValue()`

需要区分 -0 和 +0

需要正确处理 NaN 的比较

需要 Object.is() 的语义

错误处理

所有断言失败时都会抛出 TypeError 异常。可以使用 try-catch 捕获：

注意事项

性能考虑：深度相等比较（deepEqual）对于大型嵌套对象可能较慢

循环引用：当前实现不处理循环引用的对象

类型敏感：strictEqual 和 sameValue 不会进行类型转换

错误消息：始终提供有意义的错误消息以便调试

测试覆盖：结合使用不同的断言方法以获得全面的测试覆盖

与 Node.js assert 模块的对比

本模块实现了 Node.js assert 模块的核心功能：

方法	支持	备注
assert()	✓	基本断言
deepEqual()	✓	深度相等比较
notDeepEqual()	✓	深度不等比较
strictEqual()	✓	严格相等
notStrictEqual()	✓	严格不等
sameValue()	✓	Object.is 语义
throws()	✓	异常检测
doesNotThrow()	✓	无异常验证
ifError()	✓	错误检查
fail()	✓	强制失败

最佳实践

使用描述性消息

组织测试代码

选择合适的断言方法

版本历史

初始版本：实现 Node.js assert 模块的核心功能

assert

Assert 模块#

功能特性#

API 参考#

assert.assert(value, message)#

assert.deepEqual(actual, expected, message)#

assert.notDeepEqual(actual, expected, message)#

assert.strictEqual(actual, expected, message)#

assert.notStrictEqual(actual, expected, message)#

assert.sameValue(actual, expected, message)#

assert.notSameValue(actual, expected, message)#

assert.throws(fn, message)#

assert.doesNotThrow(fn, message)#

assert.ifError(value)#

assert.fail(message)#

使用示例#

基本测试#

对象和数组测试#

异常处理测试#

特殊值测试#

完整测试套件#

比较方法选择指南#

何时使用 assert.assert()#

何时使用 assert.strictEqual()#

何时使用 assert.deepEqual()#

何时使用 assert.sameValue()#

错误处理#

注意事项#

与 Node.js assert 模块的对比#

最佳实践#

相关模块#

版本历史#

Assert 模块

功能特性

API 参考

assert.assert(value, message)

assert.deepEqual(actual, expected, message)

assert.notDeepEqual(actual, expected, message)

assert.strictEqual(actual, expected, message)

assert.notStrictEqual(actual, expected, message)

assert.sameValue(actual, expected, message)

assert.notSameValue(actual, expected, message)

assert.throws(fn, message)

assert.doesNotThrow(fn, message)

assert.ifError(value)

assert.fail(message)

使用示例

基本测试

对象和数组测试

异常处理测试

特殊值测试

完整测试套件

比较方法选择指南

何时使用 `assert.assert()`

何时使用 `assert.strictEqual()`

何时使用 `assert.deepEqual()`

何时使用 `assert.sameValue()`

错误处理

注意事项

与 Node.js assert 模块的对比

最佳实践

相关模块

版本历史