es-toolkit/compat 的 negate 函数Lodash 兼容的谓词取反工具与源码解析【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkitnegate是 es-toolkit 提供的与 Lodash 兼容的工具函数用于创建一个「将原函数返回值取反」的新函数。本文以 docs/ja/compat/reference/function/negate.md 为核心结合 src/compat/function/negate.ts 的实现与 src/compat/function/negate.spec.ts 的测试用例讲解其 API、典型用法、源码原理、类型签名差异并说明为何官方文档建议多数场景直接使用逻辑非运算符!。读完后你将能正确使用negate完成数组过滤与条件取反并理解它与原生写法在性能、类型与兼容性上的取舍。函数概览negate创建一个新函数该函数将给定函数predicate的返回值取反。它通常用于数组过滤或条件逻辑中检查「相反的条件」例如把「判断偶数」的函数变成「判断奇数」的函数。const negatedFunc negate(predicate);参数predicateFunction—— 结果需要被取反的函数必须返回布尔值。返回值Function—— 一个新函数接受与原函数相同的参数返回原函数结果的相反布尔值。在兼容层compat中该函数从 src/compat/compat.ts 导出在 es-toolkit 核心层则从 src/function/index.ts 导出negate对应的现代版文档位于 docs/reference/function/negate.md。使用示例基本用法把判断偶数的函数变成判断奇数import { negate } from es-toolkit/compat; // 基本用法 function isEven(n) { return n % 2 0; } const isOdd negate(isEven); console.log(isOdd(3)); // true console.log(isOdd(4)); // false在数组过滤中使用negate最常见的场景是配合Array.prototype.filter直接从数组中筛出「不满足条件」的元素import { negate } from es-toolkit/compat; const numbers [1, 2, 3, 4, 5, 6]; const oddNumbers numbers.filter(negate(isEven)); console.log(oddNumbers); // [1, 3, 5]更现代的替代写法推荐由于negate仅仅是「把函数结果取反」官方文档明确提示大多数情况下直接使用逻辑非运算符更简单、更快// 现代替代写法推荐 const modernOddNumbers numbers.filter(n !isEven(n)); // 或者 const isOddModern n !isEven(n); const modernOddNumbers2 numbers.filter(isOddModern);复杂条件的取反negate也可以用于包含多个步骤的复杂条件函数例如把「字符串为空」取反为「有内容」import { negate } from es-toolkit/compat; function isEmpty(str) { return str.trim().length 0; } const hasContent negate(isEmpty); const messages [, , hello, , world]; const validMessages messages.filter(hasContent); console.log(validMessages); // [hello, world]negate主要应用于数组过滤和条件逻辑但正如官方文档所指出的在绝大多数情况下直接使用逻辑非运算符更符合直觉。源码实现解析negate的实现位于 src/compat/function/negate.ts。其核心逻辑非常精简export function negateF extends (...args: any[]) boolean(func: F): F { if (typeof func ! function) { throw new TypeError(Expected a function); } return function (this: any, ...args: any[]) { return !func.apply(this, args); } as F; }从源码中可以提炼出三个关键行为参数校验当传入的不是函数时抛出TypeError错误信息为Expected a function与 Lodash 行为保持一致。this绑定透传返回的新函数通过func.apply(this, args)调用原函数因此调用方的this会被正确传递。测试用例 src/compat/function/negate.spec.ts 专门验证了这一点当以negateFn.call(object, 1)形式调用时内部能通过this.isEven(n)访问到对象上的方法。多参数透传返回函数使用剩余参数...args收集并转发全部实参因此无论原函数接受多少个参数negate都能原样转发。测试用例 src/compat/function/negate.spec.ts 验证了 0 到 4 个参数的调用都能正确透传参数个数。与核心版negate的差异es-toolkit 核心层的实现位于 src/function/negate.ts两者功能等价但有一个值得注意的区别// src/function/negate.ts核心版 export function negateF extends (...args: any[]) boolean(func: F): F { return ((...args: any[]) !func(...args)) as F; }核心版直接以(...args) !func(...args)的形式调用不保留this绑定也没有非函数参数校验而 compat 版使用func.apply(this, args)透传this并抛出TypeError。这是为了与 Lodash 的行为保持兼容Lodash 的negate支持this绑定并会校验参数类型。测试与兼容性验证compat 版negate的测试位于 src/compat/function/negate.spec.ts覆盖了四个核心行为测试点验证内容基本取反negate(isEven)(1) true、negate(isEven)(2) falsespec 第 10-15 行多参数透传04 个参数的调用均能正确转发参数个数spec 第 17-47 行非法入参negate(1)抛出TypeErrorspec 第 49-51 行this绑定negateFn.call(object, 1)能通过this访问对象方法spec 第 53-61 行在仓库中的实际应用rejectnegate在 es-toolkit/compat 内部被广泛复用一个典型的例子是reject函数src/compat/array/reject.tsreturn filter(source, negate(iteratee(predicate)));reject是filter的反向操作将用户提供的谓词可以是函数、属性名、对象或[key, value]元组先通过iteratee归一化为标准谓词函数再用negate取反后交给filter从而筛选出「不满足条件」的元素。从源码结构看这正是negate在集合过滤场景中的典型落地形态也解释了为什么官方文档将「数组过滤」列为negate的首要用途。何时使用negate何时直接使用!结合文档与源码可以给出如下决策建议需要使用 Lodash 兼容行为时例如迁移既有 Lodash 代码、需要this绑定透传或非函数参数校验使用negate从es-toolkit/compat导入。追求性能与现代写法时negate每调用一次都会经过一次额外函数调用层直接写!predicate(...args)或(...args) !predicate(...args)更快、更直观这也是官方文档置于开头的 warning 所强调的。作为高阶函数传给filter等需要「回调函数」的场景negate(predicate)可以免去手写箭头函数代码意图更明确但需注意额外的函数调用开销在热路径上可以忽略不计而在超大数组的高频过滤中建议优先考虑原生写法。总而言之negate是一个实现极简但兼容性严谨的工具函数理解它的this透传、参数转发与类型校验细节既能帮助你正确迁移 Lodash 代码也能让你在合适的场景下做出「用negate还是用!」的理性选择。【免费下载链接】es-toolkitA modern JavaScript utility library thats 2-3 times faster and up to 97% smaller, a major upgrade to lodash.项目地址: https://gitcode.com/GitHub_Trending/es/es-toolkit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考