JavaScript单元测试中应排除node_modules等第三方依赖的覆盖率统计，仅聚焦业务代码；需在Jest、nyc或Vitest配置中设置路径过滤规则，而非忽略测试逻辑，同时确保mock到位并开启sourceMap以准确映射源码。
在 JavaScript 单元测试中，第三方依赖（如数据库客户端、HTTP 请求库、UI 框架组件、加密模块等）本身不是你编写的业务逻辑，统计它们的覆盖率既无意义，还会稀释真实代码的覆盖指标。关键不是“不测”，而是“不计入覆盖率统计”——即让覆盖率工具在扫描源码时跳过这些依赖文件，而不是跳过测试执行或 mock 掉它们。
明确排除目标：哪些第三方依赖该剔除
并非所有第三方代码都需要排除，重点是那些：
- 完全由 npm 安装、位于 node_modules 目录下的包（如 axios、lodash、react-dom、pg 等）；
- 你未修改、不维护、不拥有源码控制权的外部模块；
- 纯运行时依赖，不参与你的逻辑分支判断（例如仅作 import 使用，未在 if/switch 中被条件调用）。
注意：你自己封装的适配层（如 src/utils/apiClient.ts）、或对第三方模块做了逻辑包装的文件，属于业务代码，应保留并测试，不应排除。
主流覆盖率工具的排除配置方式
排除动作发生在覆盖率收集阶段，需在对应工具配置中设置路径过滤规则，而非在测试代码里手动 ignore。
wechat-article-extraction-mp-weixin-qq-com news-webpage-cleaning blog-post-parsing metadata-extraction-title-author-date multiple-output-formats-markdown-json-plain-text batch-processing-support
下载
基于三引擎设计，从微信文章、新闻和博客网页提取干净内容，支持标题作者日期元数据，多格式和批量处理。
立即学习“Java免费学习笔记（深入）”；
-
Jest：在
jest.config.js或package.json#jest中使用coveragePathIgnorePatterns：coveragePathIgnorePatterns: ['<rootdir>/node_modules/']</rootdir>
（支持正则字符串，会自动转为 RegExp；也可追加'/dist/', '.*\.d\.ts$'等） -
nyc / Istanbul：在
.nycrc或package.json#nyc中配置exclude："exclude": ["node_modules/**", "dist/**", "**/*.test.js"] -
Vitest：在
vitest.config.ts的coverage.exclude中填写 glob 模式：exclude: ['node_modules', 'dist', '**/*.test.*']
避免误伤：排除 ≠ 忽略测试逻辑
排除第三方依赖只影响覆盖率扫描范围，不影响测试运行本身：
- 你依然可以
import axios from 'axios'并在测试中使用它； - 你仍需用
jest.mock('axios')或vi.mock模拟其行为，确保测试隔离和可预测性； - mock 后的 axios 调用不会被统计覆盖率，但你自己的函数调用链（比如 service 层调用 axios 的那行
await axios.get(...)）如果没被 mock 掉，仍可能被计入——所以更推荐显式 mock 所有第三方导入，并确保其调用路径清晰。
进阶建议：结合源码映射与构建产物处理
若项目含 TypeScript 或使用打包器（Vite/Webpack），注意以下两点：
- 确保
sourceMap: true开启，否则覆盖率工具无法将生成的 JS 映射回原始 TS 文件，导致 node_modules 中的类型定义或构建产物被错误计入； - 构建产物目录（如
dist、lib）默认不应纳入覆盖率统计，已在上述 exclude 规则中覆盖；若你意外将第三方源码通过npm link或file:协议引入到src下，需单独添加路径排除，例如'../some-external-lib/src/**'。
