JS函数覆盖率达标关键在于精准覆盖核心函数而非堆砌测试数量,需聚焦导出函数、高频工具函数及0%覆盖但被引用的函数,通过构造有效输入触发完整逻辑路径,并固化阈值到CI流程。

前端项目中 JS 函数覆盖率达标,核心不是“堆测试数量”,而是让每个导出函数、关键私有函数都被真实调用并验证行为。标准通常设为 85%–95%,但真正重要的是:哪些函数没被覆盖?为什么没被调用?是废弃代码,还是调用链断裂?
先定位真正该覆盖的函数
别一上来扫全量文件。打开 coverage/lcov-report/index.html,按 “Function %” 排序,重点关注:
- 所有 导出的业务函数(如
submitOrder、formatCurrency、parseQuery) - 被多个模块 import 的工具函数(即使只有一处调用,也说明它承担了公共职责)
- 函数覆盖率 = 0% 但文件仍被引用 —— 用
grep -r "functionName" src/确认是否真没人调;若无调用点,大概率可安全删除
补覆盖要精准触发,不是随便调用
函数覆盖 ≠ 写个 test 调一下就完事。Jest/Istanbul 只记录**实际执行到的函数体**。常见失效场景:
- 只调用了函数,但参数导致它 early return(比如
if (!data) return;,传了空数据,函数体后半段根本没进) - 函数内部有异步逻辑(
await fetch()),但测试没await,后续行未执行 - 箭头函数绑定在 class 实例上(如
handleClick = () => {...}),需确保组件渲染+触发事件,不能只 new 实例后直接调用
✅ 正确做法:针对每个未覆盖函数,构造至少一组输入,让它完整走完主体逻辑(含分支、await 后、return 后语句)。
处理三类典型低覆盖函数
1. 条件判断密集型函数
例如:if (type === 'A') { ... } else if (type === 'B') { ... } else { ... }
→ 分别传 'A'、'B'、任意其他值(如 'C'),确保每个分支都进
将一个或多个 UI 原型图、线框图、产品截图或设计稿转换为标准化、可直接交付的 PRD 风格文档,供产品、设计、前端和测试共同使用。适用于 Codex 需要分析 PC 网页、桌面端、移动端、响应式页面、独立弹窗、表单、表格、看板、数据大屏或多页面流程截图,还原页面结构与交互,强制套用固定文档模板,抽取跨页面共享规则,或把一组原型沉淀为单页规范文档加整体业务流程文档的场景。不适用于纯视觉审美点评、代码实现、接口设计、埋点方案、竞品分析或无 UI 输入的业务需求创作。
2. 错误处理型函数
例如:try { ... } catch (e) { handleError(e); }
→ mock 依赖抛错(jest.mock(...).mockRejectedValue(...)),验证 handleError 是否执行
3. 纯计算/格式化函数
例如:getDisplayName(user) { return user?.firstName || user?.name || '匿名'; }
→ 测试三组:user 为 null、{ name: 'Tom' }、{ firstName: 'Jerry', name: 'Tom' }
固化标准,防止倒退
仅靠人工补漏不可持续。必须把要求写进配置和流程:
- 在
jest.config.js中为高风险目录设硬阈值:coverageThreshold: { './src/core/': { functions: 95 } } - CI 中加检查命令:
nyc check-coverage --functions 95 --per-file,失败即阻断合并 - 每次 PR 描述里注明:“本次修改涉及
validateInput函数,已补充undefined和empty string两组测试”
不复杂但容易忽略
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










