Vue项目的单元测试用的是Vue Test Utils,这是Vue.js 官方的单元测试实用工具库,在Vue和Jest之间提供了一个桥梁,暴露出一些接口,让我们更加方便的通过Jest为Vue应用编写单元测试

官网链接:介绍 | Vue Test Utils

一、新建Vue项目并使用Jest

1、运行命令vue create ,选择自定义配置

2、按需选择配置,单元测试选择Unit Testing,端到端测试选择B2B Testing

3、接下来按需选择Vue版本以及其他配置,选择Jest,一路回车确定即可,最后需不需要保存配置由你决定

4、项目创建好后,可以看到自动创建的tests文件夹和其下的一个测试文件,以及jest.config.js配置文件

5、运行package.json中的脚本命令 npm run test:unit,即可执行tests文件夹下所有的测试文件(默认后缀为spec.js/spec.ts)以及所有的js/ts文件

二、已有Vue项目集成Jest

1、在vue项目目录下运行 vue add @vue/cli-plugin-unit-jest 命令,这个命令会帮我们把相关的配置都配好,相关的依赖都装好,并生成jest.config.js文件和一个tests文件夹,目录结构同上面新建的Vue项目的目录结构相同

2、npm run test:unit 运行测试命令

三、package.json中的测试脚本命令

"scripts": {
    "test:unit": "vue-cli-service test:unit --coverage test --reporters=jest-junit",
 }

--coverage:全量覆盖率报告,会生成一个coverage文件夹,打开里面的index.html 里面会有详细的信息展示 test jest --reporters=default --reporters=jest-junit:测试报告,执行这个命令,会生成一个junit.xml文件,但要成功执行这条命令,必须执行 npm i jest-junit --save-dev,安装jest-junit依赖

更多配置可参考:https://jestjs.io/zh-Hans/docs/

四、jest.config.js文件配置

module.exports = {
  preset: "@vue/cli-plugin-unit-jest",
  verbose: true, // 多于一个测试文件运行时展示每个测试用例测试通过情况
  bail: true, // 参数指定只要有一个测试用例没有通过,就停止执行后面的测试用例
  testEnvironment: 'jsdom', // 测试环境,jsdom可以在Node虚拟浏览器环境运行测试
  moduleFileExtensions: [ // 需要检测测的文件类型
    'js',
    'jsx',
    'json',
    // tell Jest to handle *.vue files
    'vue'
  ],
  transform: { // 预处理器配置,匹配的文件要经过转译才能被识别,否则会报错
    '.+\\.(css|styl|less|sass|scss|jpg|jpeg|png|svg|gif|eot|otf|webp|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga|avif)$':
    require.resolve('jest-transform-stub'),
    '^.+\\.jsx?$': require.resolve('babel-jest')
  },
  transformIgnorePatterns: ['/node_modules/'], // 转译时忽略 node_modules
  moduleNameMapper: { // 从正则表达式到模块名称的映射,和webpack的alisa类似
    '^@/(.*)$': '<rootDir>/src/$1'
  },
  snapshotSerializers: [ // Jest在快照测试中使用的快照序列化程序模块的路径列表
    'jest-serializer-vue'
  ],
  testMatch: [ // Jest用于检测测试的文件,可以用正则去匹配
    '**/tests/unit/**/*.spec.[jt]s?(x)',
    '**/__tests__/*.[jt]s?(x)'
  ],
  collectCoverage: true, // 覆盖率报告,运行测试命令后终端会展示报告结果
  collectCoverageFrom: [ // 需要进行收集覆盖率的文件,会依次进行执行符合的文件
    'src/**/*.{js,vue}',
  ],
  coverageReporters: ['html', 'lcov', 'text-summary'], // Jest在编写覆盖率报告的配置,添加"text"或"text-summary"在控制台输出中查看覆盖率摘要
  coveragePathIgnorePatterns: ['/node_modules/'], // 需要跳过覆盖率信息收集的文件目录
  coverageDirectory: "<rootDir>/tests/unit/coverage", // Jest输出覆盖信息文件的目录,运行测试命令会自动生成如下路径的coverage文件
  coverageThreshold: { // 覆盖结果的最低阈值设置,如果未达到阈值,jest将返回失败
    global: {
      branches: 60,
      functions: 80,
      lines: 80,
      statements: 80,
    },
  },
  testURL: 'http://localhost/', // 官网没有解释,经过尝试可以随意配置ip,如果识别不出是ip则会报错
  watchPlugins: [ // jest监视插件
    require.resolve('jest-watch-typeahead/filename'),
    require.resolve('jest-watch-typeahead/testname')
  ]
};

具体可参考官方文档:介绍 | Vue Test Utils