在 javascript 项目中配置运行时插桩覆盖率统计,核心做法是使用 nyc(即 istanbul)作为底层引擎,通过 npx nyc 命令包裹你的测试运行器或应用启动命令。这样做会在代码执行时自动注入计数器,并在进程退出后生成详细的覆盖率报告。默认情况下,nyc 会忽略 node_modules、测试文件和构建产物,只统计源代码的覆盖率。若需自定义行为,可通过项目根目录的 .nycrc 配置文件或 package.json 中的 nyc 字段进行设置。

如何配置忽略特定文件或目录
要配置忽略特定文件或目录,需在 .nycrc 文件中设置 exclude-after-remap 或直接使用 exclude 数组。例如,若希望忽略 src/utils 下的所有文件,可将其加入排除列表。这样,即使这些文件被测试覆盖,也不会计入最终的覆盖率统计中。

{
"name": "my-project",
"version": "1.0.0",
"scripts": {
"test": "nyc mocha"
},
"devDependencies": {
"mocha": "^9.0.0",
"nyc": "^15.0.0"
},
"nyc": {
"exclude": [
"src/utils/**/*",
"test/**/*"
]
}
}
上述配置将导致 src/utils 和 test 目录下的文件被排除在覆盖率统计之外。运行 npm test 后,生成的报告将不包含这些文件的覆盖率数据。
如何配置输出报告的格式和位置
要配置输出报告的格式和位置,可在 .nycrc 文件中设置 reporter 和 report-dir 选项。reporter 接受一个数组,指定要生成的报告类型,如 lcov、text、html 等。report-dir 指定报告输出的目录,默认为 coverage。例如,若希望生成 HTML 报告和 LCOV 报告,并输出到 ./reports/coverage 目录,可进行如下配置:
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

{
"name": "my-project",
"version": "1.0.0",
"scripts": {
"test": "nyc mocha"
},
"devDependencies": {
"mocha": "^9.0.0",
"nyc": "^15.0.0"
},
"nyc": {
"reporter": ["html", "lcov"],
"report-dir": "./reports/coverage"
}
}
运行 npm test 后,将在 ./reports/coverage 目录下生成 index.html 和 lcov.info 文件。HTML 报告提供交互式视图,LCOV 报告可用于 CI/CD 集成。
当代码中存在未执行的分支时,覆盖率统计结果如何体现
当代码中存在未执行的分支时,覆盖率统计结果会在报告中明确标示出未覆盖的行、语句和分支。例如,若某函数包含一个 if-else 结构,但测试仅覆盖了 if 分支,则 else 分支将被标记为未覆盖。在 HTML 报告中,未覆盖的代码行会以红色高亮显示,并提供详细信息。这有助于开发者识别测试盲区,完善测试用例。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










