自动化脚本解析JS代码覆盖率数据需先确认报告格式与路径，读取coverage-final.json或lcov.info，计算行/函数/分支等加权覆盖率，并与阈值比对以触发CI失败。
在自动化脚本中解析 JavaScript 代码覆盖率数据，核心是读取测试工具（如 Jest、Vitest、Istanbul/nyc）生成的覆盖率报告文件，并提取关键指标（如行覆盖率、分支覆盖率、函数覆盖率等），用于质量门禁、CI/CD 判定或结果归档。
确认覆盖率报告格式和输出路径
大多数工具默认生成 coverage/coverage-final.json（LCOV 格式或 JSON 格式）。需确保测试命令中启用了覆盖率收集并指定了输出位置：
- Jest：添加
--coverage --coverage-directory=coverage，默认生成coverage/coverage-final.json - Vitest：启用
coverage.enabled = true，默认输出到coverage/vitest-coverage.json（JSON）或coverage/lcov.info - nyc/Istanbul：运行
nyc --reporter=json npm test，生成coverage/coverage-final.json
用 Node.js 脚本读取并解析 coverage-final.json
该 JSON 文件是嵌套结构，顶层为文件路径 → 行/函数/分支等详细统计。常用解析逻辑如下：
const fs = require('fs');
const coverageData = JSON.parse(fs.readFileSync('./coverage/coverage-final.json', 'utf8'));
<p>// 计算整体行覆盖率（加权平均）
let totalLines = 0;
let coveredLines = 0;</p><p>Object.values(coverageData).forEach(file => {
const { lines } = file;
totalLines += lines.total;
coveredLines += lines.covered;
});</p><p>const lineCoverage = totalLines ? ((coveredLines / totalLines) * 100).toFixed(2) : 0;
console.log(<code>行覆盖率: ${lineCoverage}%</code>); // 如 92.45%
提取多维度指标并做阈值校验
除行覆盖率外，还可提取函数、分支、语句覆盖率，并与预设阈值比较（常用于 CI 中失败判定）：
立即学习“Java免费学习笔记（深入）”；
- 遍历每个文件的
functions、branches、statements字段，分别计算加权覆盖率 - 聚合后对比阈值，例如：行覆盖率 ≥ 80%，分支覆盖率 ≥ 70%
- 返回非零退出码（如
process.exit(1)）可让 CI 流程中断
兼容 LCOV 格式（如 lcov.info）
若工具输出的是 lcov.info（文本格式），可用正则逐块解析：
- 每块以
SF:<filepath>开始，以end_of_record结束 - 提取
LF:（总行数）、LH:（已覆盖行数）计算行覆盖率 - 推荐使用成熟库如 lcov-parse 简化处理
