JavaScript 中覆盖率统计排除测试文件怎么配置

浅杰酱_1680

浅杰酱_1680

2026-11-21

632人浏览

原创

在 javascript 项目中,配置覆盖率统计排除测试文件的核心方法是修改覆盖率工具(如 jest、vitest 或 istanbul/nyc)的配置文件,通过设置 collectcoveragefrom 或 include/exclude 选项来指定需要统计的文件范围。通常只需将通配符从包含所有文件的模式(如 **/*.{js,ts})调整为仅匹配源代码目录(如 src/**/*.{js,ts}),即可自动忽略 test/、__tests__/ 或 *.spec.js 等测试文件。这样配置后,运行覆盖率命令时生成的报告将只反映业务代码的实际覆盖情况,避免测试逻辑本身被计入分母导致数据失真。

JavaScript 中覆盖率统计排除测试文件怎么配置

Jest 中如何配置 collectCoverageFrom 排除测试文件

在 Jest 环境中,最直接的方式是在 jest.config.js 中定义 collectCoverageFrom 数组。该属性接受一个 glob 模式列表,Jest 会基于这些模式收集文件并计算覆盖率。默认情况下,如果不配置此项,Jest 可能会尝试分析所有被测试模块依赖的文件,其中可能混入测试辅助文件或测试用例本身。通过显式指定 'src/**/*.{js,jsx,ts,tsx}',可以确保只有源文件被纳入统计。同时,建议配合 coveragePathIgnorePatterns 使用,以双重保险排除特定路径,例如 /node_modules/ 或手动指定的测试目录。这种配置方式简单且符合 Jest 的标准行为,无需额外插件即可生效。

JavaScript 中覆盖率统计排除测试文件怎么配置

// jest.config.js
module.exports = {
  // ... 其他配置
  collectCoverage: true,
  collectCoverageFrom: [
    'src/**/*.{js,jsx,ts,tsx}',
    '!src/**/*.test.{js,jsx,ts,tsx}', // 显式排除测试文件
    '!src/**/*.spec.{js,jsx,ts,tsx}',
    '!src/**/__tests__/**'
  ],
  coveragePathIgnorePatterns: [
    '/node_modules/',
    '/test/'
  ]
};

上述配置中,collectCoverageFrom 定义了正向匹配规则,而 coveragePathIgnorePatterns 提供了额外的黑名单机制。当两者同时存在时,Jest 会先根据 collectCoverageFrom 筛选候选文件,再从结果中剔除 coveragePathIgnorePatterns 中匹配的路径。这种组合策略能灵活应对复杂的目录结构。例如,如果测试文件分散在不同层级,可以通过 !src/**/__tests__/** 这样的通配符批量排除。执行 npx jest --coverage 后,控制台输出的 HTML 或 JSON 报告将严格基于 src 目录下的代码,确保覆盖率指标真实反映生产代码的质量。

Vitest 中如何通过 include 和 exclude 控制覆盖率范围

Vitest 作为 Vite 生态下的测试框架,其覆盖率配置依赖于 @vitest/coverage-v8 或 @vitest/coverage-istanbul 插件。与 Jest 不同,Vitest 更倾向于使用 coverage.include 和 coverage.exclude 选项来精细控制文件范围。在 vitest.config.ts 中,你可以定义 include: ['src/**/*.{js,ts}'] 来限定统计入口,并通过 exclude: ['**/*.test.ts', '**/*.spec.ts'] 明确移除测试文件。这种方式的优势在于它与 Vite 的构建系统紧密集成,能够利用 Vite 的预打包能力加速覆盖率数据的生成。此外,Vitest 支持按文件类型过滤,例如只统计 .ts 文件而忽略 .d.ts 声明文件,从而进一步提高报告的准确性。

FilePond 灵活的 JavaScript 文件上传库
FilePond 灵活的 JavaScript 文件上传库

FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

下载

JavaScript 中覆盖率统计排除测试文件怎么配置

// vitest.config.ts
import { defineConfig } from 'vitest/config';

export default defineConfig({
  test: {
    globals: true,
    environment: 'jsdom',
    coverage: {
      provider: 'v8',
      include: ['src/**/*.{js,ts}'],
      exclude: [
        'src/**/*.test.ts',
        'src/**/*.spec.ts',
        'src/**/__mocks__/**',
        'src/types/**' // 排除类型定义文件
      ],
      reporter: ['text', 'html']
    }
  }
});

在 Vitest 的配置中,include 数组决定了哪些文件会被注入覆盖率探针,而 exclude 数组则用于从最终报告中移除不需要的部分。值得注意的是,Vitest 的 exclude 优先级高于 include,这意味着即使某个文件匹配了 include 模式,只要它也在 exclude 列表中,就不会被统计。这种设计允许开发者在处理复杂项目结构时拥有更高的控制权。例如,对于包含大量类型定义或静态资源的项目,可以通过 exclude 轻松剔除这些不影响运行时逻辑的文件。运行 npx vitest run --coverage 后,生成的报告将仅包含 src 目录下非测试、非类型的源代码,提供清晰且无噪音的覆盖率视图。

当 src/utils/helper.test.js 未被正确排除时如何排查

如果在配置了排除规则后,发现 src/utils/helper.test.js 仍然出现在覆盖率报告中,这通常是因为通配符匹配逻辑或配置优先级出现了偏差。首先,检查 collectCoverageFrom 或 include 是否使用了过于宽泛的模式,例如 src/**/*,这会捕获所有子文件。其次,确认排除规则是否写在了正确的配置项中,且在 Jest 中 coveragePathIgnorePatterns 是正则表达式数组,而在 Vitest 中 exclude 是字符串数组。如果使用的是 Jest,确保排除模式以 / 开头并以 / 结尾,如 '/helper\.test\./'。另外,检查是否有其他插件或预设覆盖了默认配置,导致自定义规则失效。最后,可以通过在终端输出详细日志或使用调试器查看实际收集的文件列表,定位具体是哪个配置项导致了意外包含。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

javascript java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
js获取数组长度的方法
js获取数组长度的方法

在js中,可以利用array对象的length属性来获取数组长度,该属性可设置或返回数组中元素的数目,只需要使用“array.length”语句即可返回表示数组对象的元素个数的数值,也就是长度值。php中文网还提供JavaScript数组的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

6146

5

js刷新当前页面
js刷新当前页面

js刷新当前页面的方法:1、reload方法,该方法强迫浏览器刷新当前页面,语法为“location.reload([bForceGet]) ”;2、replace方法,该方法通过指定URL替换当前缓存在历史里(客户端)的项目,因此当使用replace方法之后,不能通过“前进”和“后退”来访问已经被替换的URL,语法为“location.replace(URL) ”。php中文网为大家带来了js刷新当前页面的相关知识、以及相关文章等内容

2023.07.04

1469

3

js四舍五入
js四舍五入

js四舍五入的方法:1、tofixed方法,可把 Number 四舍五入为指定小数位数的数字;2、round() 方法,可把一个数字舍入为最接近的整数。php中文网为大家带来了js四舍五入的相关知识、以及相关文章等内容

2023.07.04

6064

6

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1100

4

JavaScript转义字符
JavaScript转义字符

JavaScript中的转义字符是反斜杠和引号,可以在字符串中表示特殊字符或改变字符的含义。本专题为大家提供转义字符相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2076

5

js生成随机数的方法
js生成随机数的方法

js生成随机数的方法有:1、使用random函数生成0-1之间的随机数;2、使用random函数和特定范围来生成随机整数;3、使用random函数和round函数生成0-99之间的随机整数;4、使用random函数和其他函数生成更复杂的随机数;5、使用random函数和其他函数生成范围内的随机小数;6、使用random函数和其他函数生成范围内的随机整数或小数。

2023.09.04

4145

4

如何启用JavaScript
如何启用JavaScript

JavaScript启用方法有内联脚本、内部脚本、外部脚本和异步加载。详细介绍:1、内联脚本是将JavaScript代码直接嵌入到HTML标签中;2、内部脚本是将JavaScript代码放置在HTML文件的`<script>`标签中;3、外部脚本是将JavaScript代码放置在一个独立的文件;4、外部脚本是将JavaScript代码放置在一个独立的文件。

2023.09.12

5493

6

Js中Symbol类详解
Js中Symbol类详解

javascript中的Symbol数据类型是一种基本数据类型,用于表示独一无二的值。Symbol的特点:1、独一无二,每个Symbol值都是唯一的,不会与其他任何值相等;2、不可变性,Symbol值一旦创建,就不能修改或者重新赋值;3、隐藏性,Symbol值不会被隐式转换为其他类型;4、无法枚举,Symbol值作为对象的属性名时,默认是不可枚举的。

2023.09.20

3640

5

java访问控制修饰符介绍
java访问控制修饰符介绍

java访问控制修饰符有四种,分别是public、protected、private、默认访问修饰符。详细介绍:1、public,public是最宽松的访问控制修饰符,被修饰的类、方法和变量可以被任何其他类访问,当一个类、方法或变量被声明为public时,它们可以在任何地方被访问,无论是同一个包中的类还是不同包中的类;2、protected修饰符等等。

2023.09.20

1168

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.6万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.9万人学习