转载

简记前后端如何实现统计测试覆盖率

恰逢项目初起之时，代码基础各部分都有待完善。第一天上项目发现前后端几乎没有测试，遂决定加个测试覆盖率的限制。

前端

前端用的 react , 测试用的 jest 。Jest是Facebook的一个专门进行Javascript单元测试的工具，适合React全家桶使用。因jest本身内置代码覆盖率，便新建了** jest.config.json **来实现统计前端测试覆盖率的需求。

{
  "collectCoverage": true,
  "coverageDirectory": "reports",
  "collectCoverageFrom": [
    "src/**/*.js",
    "!**/node_modules/**"
  ],
  "coverageReporters": [
    "clover",
    "html"
  ],
  "coverageThreshold": {
    "global": {
      "branches": 80,
      "functions": 80,
      "lines": 80,
      "statements": 80
    }
  },
  "moduleFileExtensions": [
    "js"
  ],
  "modulePaths": [
    "<rootDir>"
  ],
  "testRegex": "(/__tests__/.*|//.test)//.js$"
}

复制代码

testRegex: 设置识别哪些文件是测试文件（正则形式）， 与testMatch互斥 ，不能同时写
moduleFileExtensions: 测试文件的类型 moduleFileExtensions: ['js','json','jsx','node']
rootDir: 默认值是当前目录
collectCoverage: 默认值false
coverageDirectory: 输出coverage report的目录
collectCoverageFrom: 可配置哪些文件需要收集覆盖率，哪些不需要
coverageThreshold: 配置需要达到的测试覆盖率的百分比

配置完 jest.config.json 之后，在 package.json 内配置

"scripts": {
    "test": "jest --config jest.config.json",
    "prepush": "npm run lint && git secrets --scan -r && npm run test"
 }
复制代码

当开发运行 npm run test 或 git push 时会运行测试以及统计测试覆盖率。同时项目目录 reports/index.html 可查看测试覆盖率的report. 如果测试覆盖率没有达到配置的百分比，则push会失败。

后端

后端用的 java gradle ，测试是 junit 。一开始想的比较多，老想着在prepush的时候进行控制，在spike解决统计测试率的时候没能正确的拆分task，导致花了比较长的时间去spike。后经指点，重点去寻找统计java测试覆盖率的方法。发现 jacoco 可以实现并且满足我的需求。

JaCoCo（Java Code Coverage）是一种分析单元测试覆盖率的工具。很多第三方的工具提供了对Jacoco的集成，如 Jenkins 等。使用它可以给出代码中哪些部分被单元测试测到，哪些部分没有没测到，并且给出整个项目的单元测试覆盖情况百分比。

统计测试覆盖率

首先因使用的gradle，所以需要在 build.gradle 下面引入jacoco，并进行一系列配置。

apply plugin: 'jacoco'

jacocoTestReport {
    reports {
        xml.enabled false
        html.enabled true
    }
}

复制代码

轻松配置完之后愉悦的运行 ./gradlew jacocoTestReport ，完美的在 build/jacoco/test/html/index.html 看见了测试覆盖率的report

提交！

上jenkins一看 build挂了！

在运行TASK:test的时候报错 Caused by: java.lang.NoSuchFieldException: $jacocoAccess ，但本地运行良好。怀疑是jacoco根本没被下载下来。寻觅许久，发现jacoco有个issue是跟jdk11不能友好合作。而我们恰好用的就是 jdk11 和 jacoco0.7. 。 github.com/vaskoz/core…

jacoco已经在0.8.2的版本中修复了这个问题： github.com/jacoco/jaco…

所以在我们的 build.gradle 中需要配置jacoco的版本就能解决。修改后：

apply plugin: 'jacoco'

jacoco {
    toolVersion = "0.8.2"
}

jacocoTestReport {
    reports {
        xml.enabled false
        html.enabled true
    }
}
复制代码

集成jenkins

我想要在jenkins上也能看见测试覆盖率的report，所以需要修改jenkinsfile.

stage('build') {
    agent {
        docker {
          image 'echohe/gradle'
          args '-v $HOME/.gradle:/root/.gradle -e JAVA_TOOL_OPTIONS="-Dfile.encoding=UTF8"'
        }
    }
    steps {
        sh 'gradle build '
        script {
            echo "Stage test coverage report starting: ====="
            try {
              timeout(time:25, unit:'MINUTES') {
                sh './gradlew jacocoTestReport'
              }
            } finally {
              if (fileExists('./build/reports/jacoco/test/html/index.html')) {
                echo '==== test coverage report exists, prepare to publish'
                publishHTML(target: [
                  allowMissing: true,
                  alwaysLinkToLastBuild: false,
                  keepAll: false,
                  reportDir: 'build/reports/jacoco/test/html/',
                  reportFiles: 'index.html',
                  reportName: 'test coverage report',
                  reportTitles: 'test coverage report']
                )
              } else {
                echo '==== test coverage report does NOT exists!!!'
              }
              echo "build state: ${currentBuild.result}"
              sh 'rm -rf ./build/reports/jacoco'
            }
        }
    }
}
复制代码

这样在jenkins的build stage就能生成测试覆盖率的report，并且使用了publishHTML，就能在jenkins上出现测试覆盖率的link，点击之后会显示./build/reports/jacoco/test/html/index.html的内容。