17370845950

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%，但要警惕“假高覆盖”

有些代码看似覆盖了，其实没真正验证逻辑。比如：

• 只调用了函数但没断言返回值 → 函数覆盖率 100%，但行为未知
• 写了 if (x > 0) { ... } else { ... }，但测试只跑了 if 分支 → 分支覆盖率只有 50%
• 用 /* istanbul ignore next */ 忽略某段代码，却没说明原因 → 后人无法判断是故意跳过还是遗漏

建议把分支覆盖率和函数覆盖率作为重点关注项，它们比单纯看语句数更能反映测试完整性。

基本上就这些。覆盖率本身不难测，关键是怎么用它暴露盲区，而不是把它当 KPI 来刷。