Effect v3 到 v4 如何适应 Equal.equals 默认结构相等变化并在需要时用 byReference
Effect v3 到 v4 如何适应 Equal.equals 默认结构相等变化并在需要时用 byReference【免费下载链接】effectBuild production-ready applications in TypeScript项目地址: https://gitcode.com/GitHub_Trending/ef/effectEffect v3 升级到 v4 时Equal.equals的默认比较语义发生了改变v3 对普通对象和数组使用引用相等而 v4 默认改为结构相等。如果你的代码里有用Equal.equals比较对象/数组的地方或者依赖Equal.equivalence升级后行为会变化需要逐处确认只有个别对象仍必须按引用比较时才用 v4 新增的Equal.byReference/Equal.byReferenceUnsafe显式退回引用语义。本文基于仓库中的迁移文档 migration/equality.md 与源码 packages/effect/src/Equal.ts 给出完整的对照与验证方式。前提你正在把effect从 v3 升到 v4。MIGRATION.md 说明 Effect v4 目前处于 beta 阶段、API 可能在不同 beta 版本间变动v4 所有生态包共享同一个版本号例如使用effect4.0.0-beta.0时配套的effect/sql-pg也是effect/sql-pg4.0.0-beta.0本仓库当前packages/effect/package.json中的版本号为4.0.0-rc.115。effect/Equal模块在 v3 到 v4 的导入映射中保持不变见 migration/v3-to-v4.md 的 Import Mapeffect/Equal - effect/Equal所以导入路径不用改要改的是对比较行为的预期。v3 与 v4 的默认比较行为对照在 v3 中Equal.equals对普通对象和数组使用引用相等结构比较只能在structuralRegion内临时启用区域外两个内容相同的对象不相等引自 migration/equality.md// v3 import { Equal } from effect Equal.equals({ a: 1 }, { a: 1 }) // false — reference equality Equal.equals([1, 2], [1, 2]) // false — reference equality在 v4 中Equal.equals默认就是结构相等。普通对象、数组、Map、Set、Date、RegExp都按值比较不需要任何额外开启// v4 import { Equal } from effect Equal.equals({ a: 1 }, { a: 1 }) // true Equal.equals([1, [2, 3]], [1, [2, 3]]) // true Equal.equals(new Map([[a, 1]]), new Map([[a, 1]])) // true Equal.equals(new Set([1, 2]), new Set([1, 2])) // truev4 的源码中已经没有structuralRegion以上示例中的结果即为 v4 的默认行为可直接作为升级后的预期值。另外两点需要注意的行为变化实现了Equal接口的对象不受影响仍然走自定义相等逻辑与 v3 一致。NaN相等性变了v3 中Equal.equals(NaN, NaN)返回false遵循 IEEE 754v4 中NaN等于NaNEqual.equals(NaN, NaN) // v3: false, v4: truepackages/effect/src/Equal.ts 的文档进一步描述了 v4 结构比较的细节Date按 ISO 字符串比较RegExp按字符串表示比较数组逐元素比较Map和Set按条目比较且与顺序无关例如new Map([[a, 1], [b, 2]])与new Map([[b, 2], [a, 1]])相等普通对象递归比较可枚举键没有Equal实现的函数按引用比较。把Equal.equivalence改成Equal.asEquivalence把equals包装成Equivalence的函数在 v4 中更名了引自 migration/equality.md// v3 Equal.equivalencenumber() // v4 Equal.asEquivalencenumber()源码示例展示了 v4 的用法文档示例import { Array, Equal } from effect Array.dedupeWith([1, 2, 2, 3, 1], Equal.asEquivalencenumber()) // [1, 2, 3]升级时对全项目检索Equal.equivalence把命中的调用整体替换为Equal.asEquivalence即可asEquivalence在源码中标注since 4.0.0v3 中没有这个 API不存在向后兼容问题。需要引用相等时byReference与byReferenceUnsafe默认改成结构相等后如果你的某些对象必须保持同一引用才算相等的 v3 行为例如用对象身份做缓存键、监听器去重等v4 提供两个 opt-out引自 migration/equality.md 与 packages/effect/src/Equal.tsimport { Equal } from effect const obj Equal.byReference({ a: 1 }) Equal.equals(obj, { a: 1 }) // false — reference equality两者区别byReference(obj)— 返回一个使用引用相等的Proxy原对象不变。文档强调每次调用都会创建一个新的proxy所以byReference(x) ! byReference(x)属性读取会透传回原对象aRef.x仍是1。byReferenceUnsafe(obj)— 不创建 proxy直接把原对象自身标记为引用相等返回的就是原对象byReferenceUnsafe(x) x。文档说明它性能更好但标记对对象生命周期内是不可逆的会永久改变该对象的比较方式。源码文档给出的完整示例文档示例结果const a { x: 1 } const b { x: 1 } Equal.equals(a, b) // true const aRef Equal.byReference(a) Equal.equals(aRef, b) // false Equal.equals(aRef, aRef) // true aRef.x // 1以及byReferenceUnsafe的版本const obj1 { a: 1, b: 2 } const obj2 { a: 1, b: 2 } const marked Equal.byReferenceUnsafe(obj1) Equal.equals(obj1, obj2) // false Equal.equals(obj1, obj1) // true marked obj1 // true从实现看byReference内部就是byReferenceUnsafe(new Proxy(obj, {}))两者都通过一个内部WeakSet生效equals只要发现任一操作数在该集合里且两者不是同一引用就返回false。选择原则以文档措辞为准不想动原对象就用byReference接受永久标记以换取免 proxy 开销就用byReferenceUnsafe。验证升级后的行为升级完成后把下面这段 v4 行为检查粘到你的项目里跑一遍vitest或任何能执行 TS 的运行环境均可预期结果就是文档示例中的值import { Equal } from effect // 默认结构相等 console.log(Equal.equals({ a: 1 }, { a: 1 })) // 期望 true console.log(Equal.equals([1, [2, 3]], [1, [2, 3]])) // 期望 true console.log(Equal.equals(new Map([[a, 1]]), new Map([[a, 1]]))) // 期望 true console.log(Equal.equals(NaN, NaN)) // 期望 true // 引用相等 opt-out const ref Equal.byReference({ a: 1 }) console.log(Equal.equals(ref, { a: 1 })) // 期望 false console.log(Equal.equals(ref, ref)) // 期望 true如果上面任何一项与期望不符说明依赖的effect版本仍是 v3 或版本没有对齐v4 生态包要求同版本号见 MIGRATION.md。另外注意Equal.ts源码中的 doctest带import.meta.vitest标记的示例块本身就覆盖了这些断言可以参考 packages/effect/src/Equal.ts 中equals、byReference、byReferenceUnsafe的文档示例对照。限制与注意事项来自 packages/effect/src/Equal.tsequals文档的 Gotchas使用 v4 结构相等时要知道比较结果按对象对缓存在 WeakMap 中对象在第一次比较之后不应再被修改否则后续比较结果不可信。Map和Set的比较是 O(n²) 量级大集合上要注意开销。这两条是 v4 默认结构相等的固有代价v3 时代按引用比较时不存在这些问题。参考migration/equality.md — v3 到 v4 的相等性迁移说明本文主要依据migration/v3-to-v4.md — 完整的 v3 到 v4 导入映射与 API 差异MIGRATION.md — v3 到 v4 迁移总指南与版本约定packages/effect/src/Equal.ts —equals、byReference、byReferenceUnsafe、asEquivalence的源码与 doctest【免费下载链接】effectBuild production-ready applications in TypeScript项目地址: https://gitcode.com/GitHub_Trending/ef/effect创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关新闻

挖矿病毒入侵实录:CPU飙高排查与服务器安全加固指南

挖矿病毒入侵实录:CPU飙高排查与服务器安全加固指南

1. 故障初现:好好的服务器,CPU怎么突然飙满了那天下午我正处理手头的事,突然收到一连串监控告警,同一台线上服务器的CPU使用率从平时不到20%一路冲到99%,持续了好几分钟没降下来。第一反应是业务代码出问题了&#xff…

2026/11/17 6:53:25 阅读更多 →
CIC-IDS2017入侵检测数据集实战:从数据加载到模型评估

CIC-IDS2017入侵检测数据集实战:从数据加载到模型评估

做入侵检测相关的工作,CIC-IDS2017 这个数据集基本是绕不开的。我最早用它的时候,光是把那 8 个 CSV 文件拼到一起读进内存就折腾了半天,后面又栽在数据清洗和评估指标上。这篇文章把我从下载原始数据、预处理、特征工程到模型训练测试的完整…

2026/11/17 6:53:25 阅读更多 →
Unity飞行动作游戏开发:从Rigidbody控制到战斗反馈与工程化

Unity飞行动作游戏开发:从Rigidbody控制到战斗反馈与工程化

简介:超级英雄飞行题材的3D动作游戏Unity项目源码,基于C#开发,支持Unity 2022.1.6f1及以上版本。项目围绕开放城市环境中的飞行、跳跃、拳击、踢击与射击等操作展开,玩家需完成不同层级的救援与治安任务,适合希望学习U…

2026/11/13 6:12:05 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/16 8:22:12 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/16 6:41:34 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/16 8:22:12 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/16 8:22:12 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/16 7:30:18 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/16 8:22:12 阅读更多 →

日新闻

周新闻

月新闻