如何让 Lodash 的 isEqual 正确比较具有私有属性的类实例-js教程-PHP中文网

如何让 Lodash 的 isEqual 正确比较具有私有属性的类实例

通过设置 [Symbol.toStringTag] 为 'Map'，可使 Lodash 将自定义类实例识别为原生 Map 类型，从而基于其内部键值对进行深度比较，无需修改类内比较逻辑或下游调用代码。

通过设置 `[symbol.tostringtag]` 为 `'map'`，可使 lodash 将自定义类实例识别为原生 `map` 类型，从而基于其内部键值对进行深度比较，无需修改类内比较逻辑或下游调用代码。

Lodash 的 _.isEqual 在比较对象时，并非简单遍历所有自有属性，而是依据对象的“类型标签”（由 Symbol.toStringTag 决定）选择内置的比较策略。对于原生 Map 实例，_.isEqual 会调用其 .size、.entries() 等方法，逐项比对键值对；但对普通对象（如默认的 "Object" 标签），它仅检查可枚举属性——而私有字段 #items 不可枚举，也无法被 _.isEqual 访问，导致两个空 Bobcat 实例（或仅私有 Map 内容不同）总被判定为相等。

解决方案是在类中声明 get [Symbol.toStringTag]() { return 'Map' }。此举不会改变类的行为，也不影响 instanceof 或类型检查，但会引导 Lodash 复用其针对 Map 的专用比较逻辑——该逻辑能正确访问并比对 Map 的实际内容。

以下是完整、可运行的实现示例：

const _ = require('lodash');

class Bobcat {
  #items;

  constructor() {
    this.#items = new Map();
  }

  set(key, value) {
    return this.#items.set(key, value);
  }

  get(key) {
    return this.#items.get(key);
  }

  has(key) {
    return this.#items.has(key);
  }

  delete(key) {
    return this.#items.delete(key);
  }

  clear() {
    this.#items.clear();
  }

  keys() {
    return this.#items.keys();
  }

  values() {
    return this.#items.values();
  }

  entries() {
    return this.#items.entries();
  }

  forEach(callbackFn, thisArg) {
    return this.#items.forEach(callbackFn, thisArg);
  }

  [Symbol.iterator]() {
    return this.#items[Symbol.iterator]();
  }

  get size() {
    return this.#items.size;
  }

  // ✅ 关键：告知 Lodash 此实例应按 Map 方式比较
  get [Symbol.toStringTag]() {
    return 'Map';
  }
}

// 测试用例
const cat1 = new Bobcat();
cat1.set('a', 1);

const cat2 = new Bobcat();
cat2.set('a', 1);
console.log(_.isEqual(cat1, cat2)); // true —— 内容相同

cat2.set('a', 2);
console.log(_.isEqual(cat1, cat2)); // false —— 内容不同 ✅

⚠️ 注意事项：

Symbol.toStringTag 仅影响 Object.prototype.toString.call(instance) 的返回值（如 [object Map]），不改变实例的原型链或构造函数身份；
必须同时暴露 size getter 和 entries() 方法（及其他 Map 迭代方法），否则 Lodash 可能降级为普通对象比较；
此方案完全满足“比较逻辑不侵入类内”的要求：无 isEqual() 方法，无 Lodash 特定符号（如 Symbol.for('lodash.isEqual')），纯属标准 Web API 协作；
若类需同时支持 Set、Array 等语义，可依此类推设置对应 toStringTag，但需确保接口契约一致。