eslint-plugin-unicorn no-array-reduce 规则实战解析从快照测试理解 reduce/reduceRight 的禁用与 Math.sumPrecise 建议【免费下载链接】eslint-plugin-unicornMore than 300 powerful ESLint rules项目地址: https://gitcode.com/GitHub_Trending/es/eslint-plugin-unicorn导读no-array-reduce是 eslint-plugin-unicorn 中用于禁用Array#reduce()与Array#reduceRight()的核心规则已加入recommended配置。本文以仓库中的 AVA 快照测试文件 test/snapshots/no-array-reduce.js.md 为入口逐条拆解该规则在allowSimpleOperations: false下的完整行为错误报告的定位方式、Math.sumPrecise()编辑建议的精确触发条件、以及for-of循环自动修复的生成逻辑。读完本文你将能准确预测该规则对任意一段reduce代码会报告什么、能否自动修复、是否会给出建议并能据此配置自己的 ESLint 项目。快照文件是什么规则行为的事实档案test/snapshots/no-array-reduce.js.md是由 AVA 测试框架自动生成的快照报告对应实际快照 test/snapshots/no-array-reduce.js.snap它记录的是 test/no-array-reduce.js 中test.snapshot()用例的执行结果。这类文件的意义在于它把规则对一个批次输入的完整输出错误消息、建议、修复后的代码固化为可对比的文本任何行为变化都会导致快照失配从而在 CI 中暴露出来。从快照头部可以看到这批用例统一使用以下选项Options: - allowSimpleOperations: false即所有用例都在禁止简单运算的严格模式下运行这解释了为什么连array.reduce((a, b) a b)这种求和都会被报告。快照中每个invalid(N)用例都包含Input输入代码、Error 1/1唯一一条错误以及可选的Suggestion编辑建议或Output自动修复结果。错误报告两种方法、两套消息快照中全部 40 个用例都只产生一条错误错误节点精确指向方法名callee.property。对应源码 rules/no-array-reduce.js 中定义了两条消息对reduceArray#reduce() is not allowed. Prefer other types of loop for readability.对reduceRightArray#reduceRight() is not allowed. Prefer other types of loop for readability. You may want to call Array#toReversed() before looping it.从快照可以观察到规则识别reduce/reduceRight的几种典型形态输入形态快照用例说明箭头函数回调invalid(1)array.reduce((a, b) a b)最常见的形态块体箭头函数invalid(6)array.reduce((a, b) { return a b; })块体内单条return也被识别普通函数回调invalid(7)array.reduce(function (a, b) { return a b; })FunctionExpression同样覆盖逗号表达式接收者invalid(9)(0, array).reduce(...)定位点偏移仍被报告成员/调用接收者invalid(10)-(12)object.values.reduce(...)、getNumbers().reduce(...)任意表达式接收者嵌套调用invalid(13)foo(array.reduce(...))嵌套场景照常报告可选链invalid(21)array?.reduce(...)可选调用同样报告变量声明初始化invalid(14)const sum array.reduce(...)同时触发 for 循环自动修复BigInt 类型化数组invalid(36)-(39)new BigInt64Array().reduce(...)类型化数组共享Array#reduce同样被禁用从源码结构看规则的匹配基于 rules/no-array-reduce.js 中的三个cases常规方法调用、[].reduce.call()/Array.prototype.reduce.call()、以及.apply()变体。快照用例仅覆盖了第一类常规调用但 test/no-array-reduce.js 的普通测试中明确覆盖了[].reduce.call(array, ...)、Array.prototype.reduce.apply(...)等形态它们同样报告错误只是不提供自动修复。Math.sumPrecise() 建议什么情况下给出什么情况下不给这是快照文件信息量最大的部分。当allowSimpleOperations: false时对纯求和的reduce规则会在报错的同时给出建议SuggestionSwitch to Math.sumPrecise().例如// 输入 array.reduce((a, b) a b) // 建议的修改 Math.sumPrecise(array)快照 invalid(2) 展示了带0初始值的变体建议结果相同Math.sumPrecise(array)因为0作为初始值在语义上是冗余的。快照还证明建议会保留接收者表达式原样Math.sumPrecise((0, array))、Math.sumPrecise(object.values)、Math.sumPrecise(getNumbers())并且能正确嵌套在外部调用中foo(Math.sumPrecise(array))。建议的判定逻辑集中在源码 rules/no-array-reduce.js 的getSumPreciseSuggestions()中。结合源码与快照可以归纳出给出建议的充分条件回调是箭头函数或普通函数且回调体含块体return形式是a b二元表达式操作数恰好是前两个参数顺序不限见 invalid(5)b a无初始值或初始值是字面量0invalid(16) 的, 10就不给建议不使用可选链invalid(21) 的array?.reduce(...)不给建议调用内部无注释invalid(22) 的/* keep */不给建议参数是普通标识符而非解构模式invalid(23) 的([a], b)不给建议累积器与元素参数在类型上可证明是 number。类型感知建议的安全阀由于Math.sumPrecise()对非数字元素会直接抛异常而非像那样隐式强转规则在有类型信息可用时会跳过对可证明非数字的求和建议。快照中 TypeScript 用例清楚展示了这一行为有建议(a: number, b: number)、(a, b: number)、reducenumber(...)、number[]、readonly number[]、BigInt64Array | Int8Array并集之外的数字场景无建议(a, b: string)、(a: string, b)、(a: bigint, b: bigint)、string[]、boolean[]、bigint[]以及new BigInt64Array()等 BigInt 类型化数组。invalid(32) 还验证了一个细节多余的第 3、4 个参数index、array不影响建议的给出因为类型检查只针对累积器和元素两个参数。这些行为对应源码中的isKnownNonNumber()与isKnownBigIntTypedArray()两个工具函数分别定义于 rules/utils/is-number.js 和 rules/utils/is-array.js测试通过typescript-eslint/parser的projectService类型检查器解析元素类型见 test/no-array-reduce.js。为什么是建议而不是自动修复源码注释rules/no-array-reduce.js与规则文档 docs/rules/no-array-reduce.md 都明确指出Math.sumPrecise()与求和不完全等价——它要求每个元素都是数字否则抛异常而非强转、对空数组返回-0、且精度更高导致结果可能不同。因此它只能作为手动确认的编辑建议hasSuggestions: true而非--fix自动修复。for-of 循环自动修复何时触发、生成什么样的代码快照 invalid(14) 是唯一同时给出Output自动修复结果的用例// 输入 const array []; const sum array.reduce((a, b) a b); // 修复输出 const array []; let sum; for (const [index, b] of array.entries()) { if (index 0) { sum b; continue; } sum sum b; }注意几个实现细节无初始值时循环体首轮index 0直接把元素赋给结果变量并continue从第二轮起才执行累积表达式——这与Array#reduce()无初始值时的语义一致有初始值时见 test/no-array-reduce.js 的输出则直接let result initialValue;然后逐轮累积循环体退化为单条赋值累积表达式会做变量替换回调参数a、b被替换为实际可用的变量名result、item/b并用array.entries()解构出[index, element]结果变量从const变为let因为循环内需要反复赋值。自动修复的触发条件在 rules/no-array-reduce.js 与createFix()同文件 L466-L560中定义快照之外的核心限制包括接收者必须是局部const数组标识符arrayVariable检查因此getArray().reduce(...)这类调用只报告不修复invalid 列表中的const result getArray().reduce(callback, initialValue);正是此例reduce调用必须是单个const变量声明语句的初始化器isSingleDeclaratorVariableInitializer所以for (const result array.reduce(...); ...)或解构声明const {result} ...都不修复回调可以是内联箭头/普通函数也可以是在调用前声明的局部const回调标识符测试用例 test/no-array-reduce.js 展示了const callback (total, item) ...; const result array.reduce(callback, initialValue);被修复为内联调用callback(result, element, index, array)回调体必须足够简单内联兼容不能包含嵌套方法、直接eval、arguments/this、new.target、async/generator、函数自引用、参数写操作如item 1、结果变量被回调读取、数组在回调内被读写等对应 test/no-array-reduce.js 一整批只报告不修复的用例带 TypeScript 类型注解的调用如const result: Result ...、reduceResult(...)不修复初始值有副作用时不修复。Array#reduceRight()则从不自动修复——因为语义上它从数组尾部开始规则的定位是提示开发者改用Array#toReversed()后正向遍历或手动编写倒序循环见 docs/rules/no-array-reduce.md 中的示例。allowSimpleOperations 选项默认放行简单运算规则只有一个选项allowSimpleOperations默认true定义于 rules/no-array-reduce.js 的 schema 与 L704 的 defaultOptions。其语义docs/rules/no-array-reduce.md为true默认回调体是单一二元表达式的简单运算如total item、total - item、total * item、total / item及块体return形式被放行不报告false彻底禁用reduce/reduceRight包括简单求和——此时求和会额外获得Math.sumPrecise()建议。从源码 rules/no-array-reduce.js 的isSimpleOperation()看简单运算特指回调体为单条二元表达式箭头简写体或块体内单条return像return (total / item) * 100这种复合表达式即便只有一个return也不属于简单运算。测试 test/no-array-reduce.js 验证了默认模式下total item、{ return total - item }、function (total, item) { return total * item }均合法而{ return (total / item) * 100 }会被报告。规则文档还给出了使用建议确实需要reduce时可用// eslint-disable-next-line unicorn/no-array-reduce注释豁免偏好函数式编程的团队也可以整体关闭该规则docs/rules/no-array-reduce.md。实用速查常见写法会被如何处理综合快照与测试下面这张速查表可以直接指导日常编码决策代码默认配置allowSimpleOperations: true严格模式falsearray.reduce((t, i) t i)✅ 放行❌ 报告 Math.sumPrecise 建议array.reduce((t, i) t - i)✅ 放行❌ 报告无建议array.reduce((t, i) { return (t / i) * 100; }, 0)❌ 报告❌ 报告const r arr.reduce((t, i) transform(t, i), init)arr 为局部 const❌ 报告 for 循环自动修复❌ 报告 for 循环自动修复getArray().reduce(fn, init)❌ 报告不修复❌ 报告不修复array.reduceRight(fn, init)❌ 报告不修复❌ 报告不修复[].reduce.call(array, fn)/Array.prototype.reduce.apply(...)❌ 报告不修复❌ 报告不修复array?.reduce((t, i) t i)❌ 报告❌ 报告无建议总结no-array-reduce规则体现了一个典型风格禁令 智能迁移的设计默认放行最常见的简单求和allowSimpleOperations: true对其余reduce/reduceRight一律报告对满足精确条件的直接reduce提供for-of循环自动修复在严格模式下对纯数字求和给出Math.sumPrecise()编辑建议并借助 TypeScript 类型信息规避非数字场景的误建议。快照文件 test/snapshots/no-array-reduce.js.md 正是这些行为的最权威记录——任何对该规则行为的疑问都可以回到这份快照中找到确凿答案。【免费下载链接】eslint-plugin-unicornMore than 300 powerful ESLint rules项目地址: https://gitcode.com/GitHub_Trending/es/eslint-plugin-unicorn创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
