Node.js assert.deepEqual(actual, expected[, message])用法及代码示例

assert.deepEqual(actual, expected[, message])

参数

• actual <any>
• expected <any>
• message <string> | <Error>

严格的断言模式

assert.deepStrictEqual() 的别名。

传统断言模式

测试 actual 和 expected 参数之间的深度相等性。考虑改用 assert.deepStrictEqual() 。 assert.deepEqual() 可以产生令人惊讶的结果。

深度相等意味着子对象的可枚举"own" 属性也由以下规则递归评估。

比较细节#

• 原始值与== 运算符, 除了NaN.如果双方都是相同的，则视为相同NaN.
• Type tags 个对象应该相同。
• 仅考虑 enumerable "own" properties。
• Error 名称和消息总是被比较，即使它们不是可枚举的属性。
• Object wrappers 作为对象和展开的值进行比较。
• Object 属性比较无序。
• Map 键和 Set 项是无序比较的。
• 当双方不同或双方遇到循环引用时，递归停止。
• 实现不测试对象的 [[Prototype]] 。
• Symbol 属性不进行比较。
• WeakMap 和 WeakSet 比较不依赖于它们的值。
• RegExp lastIndex、标志和源始终进行比较，即使这些不是可枚举的属性。

以下示例不抛出AssertionError因为基元是使用== 运算符.

import assert from 'node:assert';
// WARNING: This does not throw an AssertionError!

assert.deepEqual('+00000000', false);const assert = require('node:assert');
// WARNING: This does not throw an AssertionError!

assert.deepEqual('+00000000', false);

"Deep" 相等意味着子对象的可枚举"own" 属性也被评估：

import assert from 'node:assert';

const obj1 = {
  a: {
    b: 1
  }
};
const obj2 = {
  a: {
    b: 2
  }
};
const obj3 = {
  a: {
    b: 1
  }
};
const obj4 = Object.create(obj1);

assert.deepEqual(obj1, obj1);
// OK

// Values of b are different:
assert.deepEqual(obj1, obj2);
// AssertionError: { a: { b: 1 } } deepEqual { a: { b: 2 } }

assert.deepEqual(obj1, obj3);
// OK

// Prototypes are ignored:
assert.deepEqual(obj1, obj4);
// AssertionError: { a: { b: 1 } } deepEqual {}const assert = require('node:assert');

const obj1 = {
  a: {
    b: 1
  }
};
const obj2 = {
  a: {
    b: 2
  }
};
const obj3 = {
  a: {
    b: 1
  }
};
const obj4 = Object.create(obj1);

assert.deepEqual(obj1, obj1);
// OK

// Values of b are different:
assert.deepEqual(obj1, obj2);
// AssertionError: { a: { b: 1 } } deepEqual { a: { b: 2 } }

assert.deepEqual(obj1, obj3);
// OK

// Prototypes are ignored:
assert.deepEqual(obj1, obj4);
// AssertionError: { a: { b: 1 } } deepEqual {}

如果这些值不相等，则会抛出一个 AssertionError ，并将 message 属性设置为等于 message 参数的值。如果 message 参数未定义，则分配默认错误消息。如果 message 参数是 Error 的实例，那么它将被抛出而不是 AssertionError 。