Remeda 迁移指南：从 `uniqBy` 到 `uniqueBy` 的重命名实战与源码解读

开发工具【免费下载链接】remedaA utility library for JavaScript and TypeScript.项目地址https://gitcode.com/gh_mirrors/re/remeda点击查看免费下载本篇指南面向正在从 Remeda v1 升级到 v2 的开发者完整讲解uniqBy被重命名为uniqueBy的来龙去脉、最小改动迁移步骤并结合当前仓库中 uniqueBy 的实现源码 与测试用例深入剖析uniqueBy的引用去重原理、懒执行机制、类型推导增强以及回调签名细节。读完本文你可以一步到位完成uniqBy的迁移并掌握uniqueBy的正确用法与底层行为。迁移背景为什么uniqBy被重命名uniqBy的重命名并非孤立事件而是 Remeda v2 一次系统性改名的一部分。根据官方迁移总览文档 migration-removed.mdRemeda 早期大量借鉴了 Lodash 与 Ramda 的命名这些名字未必与 ECMAScript 标准命名一致因此 v2 统一选择向标准靠拢同时团队还决定去掉缩写和部分拼写改用完整的英文单词uniquniquify 的缩写就是最典型的例子// Was uniq(DATA); // Now unique(DATA);受此影响uniq、uniqBy、uniqWith三个函数在 v2 中分别更名为unique、uniqueBy、uniqueWith。相关迁移文档同样存在于 uniq.md 与 uniqWith.md 中可以一并对照迁移。注意这次变更只涉及名称函数的参数顺序、语义与返回行为均保持不变属于纯重命名类破坏性变更。最小迁移直接替换函数名uniqBy到uniqueBy的迁移极其简单——只改函数名参数一个都不动。原迁移文档给出的对照如下// Wasv1 uniqBy(data, mapper); // Nowv2 uniqueBy(data, mapper);两个版本的调用签名完全一致data为待去重的数组mapper为从元素中提取“去重键”的函数。这意味着你可以在代码库中直接全局替换uniqBy为uniqueBy随后处理 TypeScript 可能暴露出的类型问题即可。迁移文档uniqBy.md同时提示Remeda v1 的最新版本中所有被重命名的函数都已标记为 deprecated 并带有迁移建议。因此官方推荐的稳妥路径是——先升级到最新的 v1 版本依据弃用警告逐个替换再升级到 v2这样可以将迁移成本摊薄、逐点验证避免一次性大规模改动参见 migration-intro.md。uniqueBy的完整用法两种调用形态重命名后的uniqueBy是一个典型的 Remeda 双签名函数支持data-first与data-last两种调用形态定义见 uniqueBy.ts// 形态一data-first数据优先 uniqueBy(data, keyFunction); // 形态二data-last函数优先配合 pipe 使用 uniqueBy(keyFunction)(data); // 或 pipe(data, uniqueBy(keyFunction));官方文档示例uniqueBy.ts演示了按对象属性去重的典型场景uniqueBy( [{ n: 1 }, { n: 2 }, { n: 2 }, { n: 5 }, { n: 1 }, { n: 6 }, { n: 7 }], (obj) obj.n, ); // [{n: 1}, {n: 2}, {n: 5}, {n: 6}, {n: 7}]其语义为返回一个新数组其中每个元素在经keyFunction变换后只保留首次出现的一份。去重的依据是映射后的键值而不是元素本身因此非常适合对对象数组按某个字段如id、name去重。源码实现基于Set的引用级键去重uniqueBy的运行时实现非常精简核心逻辑位于 uniqueBy.ts 的lazyImplementationfunction lazyImplementationT( keyFunction: (item: T, index: number, data: readonly T[]) unknown, ): LazyEvaluatorT { const set new SetReturnTypetypeof keyFunction(); return (value, index, data) { const key keyFunction(value, index, data); if (set.has(key)) { return SKIP_ITEM; } set.add(key); return { done: false, hasNext: true, next: value }; }; }值得注意的实现细节去重键的比较基于SetSameValueZero 语义也就是引用级比较。因此uniqueBy无法用于“深比较”两个结构相同但引用不同的对象——那是uniqueWithisDeepEqual的职责范畴。键值可以是任意类型unknown数字、字符串、对象引用均可作为键只要键值在Set中已存在对应元素就会被跳过返回SKIP_ITEM哨兵定义于 utilityEvaluators.ts。去重是稳定的保留的是每个键首次出现的那个元素且保持原数组顺序。回调签名是(item, index, data)index为当前元素在数组中的位置data为当前已处理的数组在懒执行场景下按需重建见后文。uniqueBy本身没有“拿到完整数组再处理”的急切实现而是直接借助purryFromLazy见 purryFromLazy.ts将懒实现包装成双签名形式data-first 形态等价于pipe(data, { lazy, lazyArgs })data-last 形态则返回一个携带懒定义、可直接放入pipe的函数。purryFromLazy内部通过参数个数args.length与lazy.length的差值自动判别是>pipe( [{ n: 1 }, { n: 2 }, { n: 2 }, { n: 5 }, { n: 1 }, { n: 6 }, { n: 7 }], uniqueBy((obj) obj.n), take(3), ); // [{n: 1}, {n: 2}, {n: 5}]这一行为被测试用例明确验证uniqueBy.test.ts通过createLazyInvocationCounter统计回调实际执行次数——当uniqueBy在take(3)之前时输入[1, 2, 2, 5, 1, 6, 7]只迭代了4 次得到[1, 2, 5]当take(3)在uniqueBy之前时上游仅迭代3 次得到[1, 2]。这说明把uniqueBy放在管道前部、take等截断算子放在后部可以大幅减少对超大数组的回调调用次数这是 v2 中uniqueBy相比 v1 的uniqBy在性能使用方式上的一个关键优势。类型层面的增强Deduped输出类型uniqueBy的返回类型不是简单的T[number][]而是专用工具类型DedupedT定义于 Deduped.ts。该类型对输入进行条件分支推导空数组[]→ 输出[]元组[Head, ...Rest]→ 输出[Head, ...Rest[number][]]即首元素类型被保留后续元素退化为联合类型数组非空但非元组的数组 → 输出NonEmptyArrayT[number]保证非空其余 →T[number][]。这个类型设计充分利用了“去重后首元素必然保留”这一特性让uniqueBy在处理as const元组时能给出比Array.prototype.filter更精确的推导结果。与之配套的类型测试位于 uniqueBy.test-d.ts其中验证了回调的data参数在>uniqueBy(DATA, (item) Number.parseInt(item));这也是 migration-variants.md 中针对“indexed 变体并入基础函数”这一变更给出的核心建议。与unique、uniqueWith的关系uniqBy的两兄弟同样改名三者在 v2 中共同构成完整的去重函数族且都基于懒实现unique(data)按元素自身引用去重无需映射函数unique.tsuniqueBy(data, keyFunction)按keyFunction提取的键去重本文主角uniqueWith(data, isEquals)按自定义比较器isEquals(a, b)去重可处理深比较场景uniqueWith.ts。选择建议能直接用unique就用unique需要按属性去重用uniqueBy需要自定义相等语义如深比较对象用uniqueWith配合isDeepEqual。三者返回值均为DedupedT迁移时从uniqBy换成uniqueBy即可无缝衔接。迁移验证清单完成替换后建议按以下清单验证迁移质量全局搜索uniqBy确认代码库中不再残留 v1 名称v1 最新版的弃用警告也会帮你定位编译检查uniqueBy的新类型推导可能暴露下游类型问题逐个按上文策略处理行为回归关注回调为引用函数如parseInt的位置防止多参数副作用性能用例如果对超大数组去重可参照 uniqueBy.test.ts 的思路确认uniqueBy在管道中与take等截断算子组合时确实触发懒执行、避免全量遍历。总结uniqBy → uniqueBy是 Remeda v2 中成本最低的一类迁移函数名一改、参数不变。但替换之后uniqueBy带来的懒执行去重、Deduped精确类型推导与三参数回调签名才是真正值得关注的新能力。结合本文的源码与测试证据你可以放心地把 v1 代码迁移到 v2并顺势用上更优的性能与类型体验。赞分享开发工具【免费下载链接】remedaA utility library for JavaScript and TypeScript.项目地址https://gitcode.com/gh_mirrors/re/remeda点击查看免费下载相关推荐从 Ramda uniqBy 迁移到 remeda uniqueBy按键去重的实战指南与懒加载原理从 Ramda uniqBy 迁移到 remeda uniqueBy 按键去重的实战指南与懒加载原理 本文基于 remeda 文档站中 Ramda → rem开发工具Remeda v2 迁移指南从 toPairs 重命名迁移到 entriesRemeda v2 迁移指南从 toPairs 重命名迁移到 entries 本指南以 Remeda 官方 v1 迁移文档 toPairs.md https开发工具Remeda v2 迁移指南createPipe 更名为 piped 的重命名解析与源码实现Remeda v2 迁移指南createPipe 更名为 piped 的重命名解析与源码实现 Remeda 从 v1 升级到 v2 时对一批函数进行了重命名开发工具上一篇Borderless Gaming终极指南如何免费实现无缝游戏窗口切换下一篇Apache DataFusion 运行时 Metrics 指南借助 EXPLAIN ANALYZE 洞察执行算子性能创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考