JavaScript代码覆盖率衡量测试用例执行的语句、分支、函数和行数,主流工具如Jest/Vitest基于Istanbul统计四类指标:语句、分支、函数、行覆盖率;需警惕“假高覆盖”,应重点关注分支与函数覆盖率以暴露测试盲区。

JavaScript代码覆盖率,指的是你的测试用例实际执行到了多少行、多少分支、多少函数或多少语句。它不是衡量测试质量的唯一标准,但能帮你快速发现哪些代码压根没被测到——比如漏掉的 if 分支、未调用的工具函数、或者永远走不到的错误处理逻辑。
覆盖率通常看这四个维度
主流工具(如 Istanbul / nyc / Jest 内置覆盖率)默认统计以下四类指标:
- 语句覆盖率(Statements):有多少行可执行语句被执行过(注意:声明、注释、空行不算)
- 分支覆盖率(Branches):if/else、三元运算、逻辑与或等所有可能路径中,跑过了几条
- 函数覆盖率(Functions):定义的函数里,有多少个至少被调用过一次
- 行覆盖率(Lines):和语句覆盖率高度重合,但更贴近“物理行”的概念,部分工具会单独列出
常用测量方式(以现代前端项目为例)
大多数项目用 Jest 或 Vitest 做测试,它们都内置了基于 Istanbul 的覆盖率报告功能,开箱即用:
- Jest:在 jest.config.js 中开启
collectCoverage: true,运行npm test -- --coverage - Vitest:在 vitest.config.ts 加
coverage: { enabled: true },运行npm run test:coverage - 生成的 HTML 报告会放在 coverage/index.html,点进去就能看到每文件、每函数、每行的高亮详情
别盲目追求 100%,但要警惕“假高覆盖”
有些代码看似覆盖了,其实没真正验证逻辑。比如:
立即学习“Java免费学习笔记(深入)”;
- 只调用了函数但没断言返回值 → 函数覆盖率 100%,但行为未知
- 写了 if (x > 0) { ... } else { ... },但测试只跑了 if 分支 → 分支覆盖率只有 50%
- 用
/* istanbul ignore next */忽略某段代码,却没说明原因 → 后人无法判断是故意跳过还是遗漏
建议把分支覆盖率和函数覆盖率作为重点关注项,它们比单纯看语句数更能反映测试完整性。
基本上就这些。覆盖率本身不难测,关键是怎么用它暴露盲区,而不是把它当 KPI 来刷。











