es-toolkit/compat 的 method预创建按路径调用对象方法的函数【免费下载链接】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-toolkitmethod是 es-toolkit 兼容层es-toolkit/compat中与 Lodash 完全对齐的工具函数它接收一个属性路径和若干预设参数返回一个等待对象的高阶函数把这个返回函数传给任意对象就会在指定路径上以正确的this绑定调用该对象上的方法并把预设参数原样传入。读完本文你能掌握method的参数与返回值语义、它在函数式编程和Array.map等场景中的典型用法以及从源码层面理解其路径解析、this绑定与空值处理的完整实现链路。什么是 method方法调用的柯里化封装在函数式编程中经常需要先固定调用方式后传入接收者。比如要对一组对象逐个调用obj.calc.sum(5, 3)直接写匿名函数略显啰嗦。method将「路径 参数」部分应用partial application掉剩下的object参数延迟到调用时才提供const methodFunc method(path, ...args);这与 Lodash 的_.method行为一致是 es-toolkit/compat 兼容层 的一部分——该层 1:1 镜像 Lodash 的接口与行为自 v1.39.3 起通过 Lodash 官方测试套件因此从lodash迁移过来时调用点无需改动。基本用法与参数说明函数签名为method(path, ...args)pathPropertyKey | PropertyKey[]要调用的方法的路径。可以是点分字符串a.b、键数组[a, b]、数字索引或 symbol...argsany[]调用方法时传入的参数在创建函数时一次性固定返回值一个(object: any) any函数调用时接收目标对象在其path路径处取出方法并连同args一起执行。import { method } from es-toolkit/compat; const object { a: { b: function (x, y) { return x y; }, }, }; // 创建一个方法调用函数 const add method(a.b, 1, 2); console.log(add(object)); // 3 // 对数组中每个对象调用相同路径的方法 const objects [{ calc: { sum: (a, b) a b } }, { calc: { sum: (a, b) a * b } }]; const calculate method(calc.sum, 5, 3); objects.map(calculate); // [8, 15]第二个例子展示了它的核心优势method(calc.sum, 5, 3)生成一个可复用的一等函数直接交给map避免为每个元素重复书写调用逻辑。嵌套路径与 this 绑定method同样支持嵌套路径。值得注意的一点是被测方法内部访问this.name而调用结果依然是Mr. John说明this被正确绑定到了方法所在的父对象而非全局环境import { method } from es-toolkit/compat; const obj { users: { getName: function (prefix) { return prefix this.name; }, name: John, }, }; const getUserName method(users.getName, Mr. ); getUserName(obj); // Mr. John这一点在测试中也有专门验证method.spec.ts 中 should invoke deep property methods with the correctthisbinding 用例断言{ a: { b() { return this.c; }, c: 1 } }上method(a.b)的调用结果为1。源码实现method 只是 invoke 的柯里化外壳method.ts 的实现极为简洁——它本身不解析路径只是把参数固化进闭包把真正的路径解析与调用交给invokeexport function method(path: PropertyKey | readonly PropertyKey[], ...args: any[]): (object: any) any { return function (object?: unknown) { return invoke(object, path, args); }; }真正的工作量在 invoke.ts 中。整个调用链可以概括为参数展平invoke入口先执行args args.flat(1)以兼容传一个数组当参数列表的 Lodash 习惯写法空值守卫object null时直接返回undefined不会抛出异常路径分流invoke.tspath为字符串时先检查对象是否直接拥有该字符串键Object.hasOwn。若有则按单一键处理否则交给 toPath 解析点分/方括号深路径a.b→[a, b]a[b.c]→[a, b.c]path为数字或 symbol 时作为单段键直接使用path为数组时逐段使用其他类型则包装成单段。这个直接键优先于路径的策略有对应测试should use a key over a path 用例中对象同时含有a.b键和a.b嵌套method(a.b)命中的是扁平键。父对象定位与方法执行invokeImpl用get(object, path.slice(0, -1), object)取到方法的父对象路径缺失时得到undefined整体返回undefined再把最后一段键取出方法并执行func?.apply(parent, args)——apply的第二参数parent正是this绑定正确的来源。另外从测试可以看到path支持隐式类型强制should coercepathto a string 用例中null、undefined、自定义toString的函数、普通对象分别被强制为null、undefined、fn、[object Object]后作为键使用继承属性原型链上的方法同样可以被调用这与 Lodash 行为一致。边界行为一览均有测试佐证以下行为均可在 method.spec.ts 中找到对应断言迁移 Lodash 代码时可以放心依赖场景行为依据用例深路径a.b/[a,b]正常调用字符串与数组路径等价should work with deep property values数字路径如method(array, 1)视为数组索引键should work with a non-stringpath原型链上的方法可被调用含继承查找should work with inherited property values对象为null/undefined/ 未传返回undefined不抛错should returnundefinedwhenobjectis nullish路径中间段缺失返回undefinedshould returnundefinedif parts ofpathare missing部分应用参数创建时的...args原样传给方法should apply partial arguments to function与 methodOf 的对比谁在前谁在后method与 methodOf 共享同一个invoke内核只是柯里化的方向相反method(path, ...args)→ 返回函数接收object适合对一组不同对象调用同一方法本文开头的map场景methodOf(object, ...args)→ 返回函数接收path适合对同一个对象按不同路径调用方法。选择哪个取决于变化量在哪一侧接收者集合固定时用methodOf路径与参数固定时用method。引入方式与迁移建议method位于 compat 子包标准引入方式import { method } from es-toolkit/compat;在无 tree-shaking 环境CommonJSrequire()、React Native、无打包器的 Node.js 脚本中也可以按需引入单函数入口只加载该函数依赖的文件import method from es-toolkit/compat/method; // 或 const method require(es-toolkit/compat/method);对于正在从 Lodash 迁移的项目推荐路径是先整体替换导入为es-toolkit/compat保持调用点不动再逐步整理为严格的es-toolkitAPI对于新项目且本就不依赖 Lodash则可直接使用es-toolkit主包。method这类高阶函数在两种包中的位置不同compat 面向迁移对齐选型时留意这一点即可。本文参考的文档与代码method 兼容文档、method 实现、invoke 实现、methodOf 实现、toPath 实现、method 测试、compat 包说明。【免费下载链接】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），仅供参考
