
通过设置 [Symbol.toStringTag] 为 'Map',可使 Lodash 将自定义类实例视为原生 Map 进行深度比较,从而基于其内部键值对内容(而非引用)返回准确的相等性结果。
通过设置 `[symbol.tostringtag]` 为 `'map'`,可使 lodash 将自定义类实例视为原生 `map` 进行深度比较,从而基于其内部键值对内容(而非引用)返回准确的相等性结果。
Lodash 的 _.isEqual 在比较对象时,会依据对象的 [[Class]] 内部标签(由 Symbol.toStringTag 控制)决定使用哪种比较策略。对于原生 Map 实例,_.isEqual 会遍历其键值对并逐项比对;而对于普通对象(如默认的 "Object" 标签),它仅比较可枚举自有属性——而私有字段 #items 不在枚举范围内,因此两个空 Bobcat 实例总被判定为相等。
解决方案是不修改类的公共 API,也不添加任何比较方法,仅通过 get [Symbol.toStringTag]() 显式声明该类“应被视作 Map”:
class Bobcat {
#items;
constructor() {
this.#items = new Map();
}
// ... 所有 Map 委托方法(set/get/has/keys/values/entries/forEach/[Symbol.iterator]/size)
get [Symbol.toStringTag]() {
return 'Map';
}
}
✅ 关键点说明:
-
Symbol.toStringTag是 ECMAScript 标准规范定义的内置 symbol,用于控制Object.prototype.toString.call(obj)的返回值(如[object Map]),Lodash 内部正依赖此机制识别数据结构类型; - 返回
'Map'后,_.isEqual会调用其内置的Map比较逻辑:遍历cat1.entries()和cat2.entries(),逐对比较键与值(支持嵌套结构、类型安全); - 私有字段
#items无需暴露,也不影响封装性;所有Map方法均通过委托实现,行为与原生Map一致; - 该方案完全满足“比较逻辑必须在类外部”的要求——
_.isEqual本身未被侵入,类也未定义isEqual、[Symbol.for('lodash.isEqual')]等定制钩子。
⚠️ 注意事项:
- 确保完整代理
Map的所有语义关键属性(如size),否则_.isEqual可能因size不匹配提前返回false; - 若类还包含其他非
Map语义的状态(如额外的私有字段#meta),此方案将忽略它们——此时需权衡:若业务上该类本质就是Map的封装,则合理;否则应改用自定义比较器(如_.isEqualWith)或重构设计; - 此技巧同样适用于
Set、Date、RegExp等原生类型标签,但务必确保行为语义真正对齐,避免误导性比较。
最终,cat1.set('a', 1) 与 cat2.set('a', 2) 将正确返回 false,而 cat1.set('a', 1) 与 cat2.set('a', 1) 返回 true——无需侵入类内、无需修改调用方,纯粹依靠标准符号契约实现精准、可预测的深度相等判断。










