Skip to content

采集 Node.js 覆盖率 ​

有多种方法可以从Node.js收集V8覆盖率数据:

  • NODE_V8_COVERAGE=dir

    • 使用Node.js环境变量NODE_V8_COVERAGE=dir来启动程序, 然后在进程正常结束之后,覆盖率数据将自动保存到指定的dir目录.
    • 从dir目录读取所有的JSON文件,来生成覆盖率报告
    • 参见例子:

    cross-env NODE_V8_COVERAGE=.temp/v8-coverage-env node ./test/test-node-env.js && node ./test/generate-report.js

  • V8 API + NODE_V8_COVERAGE

    • 如果进程不能正常结束,比如被强制关闭,或者压根就不结束,比如启动了一个服务类的,那么需要手动写入覆盖率数据,这里需要调用接口v8.takeCoverage()
    • 参见例子:

    cross-env NODE_V8_COVERAGE=.temp/v8-coverage-api node ./test/test-node-api.js

  • Inspector API

    • 首先连接到Node.js的V8 inspector
    • 然后使用inspector的覆盖相关API来开启和收集覆盖率数据
    • 参见例子:

    node ./test/test-node-ins.js

    • vm的例子 (注意这里需要使用scriptOffset,因为vm里一般都会加一层包裹代码,需要这个偏移位置来修正覆盖率数据块的位置):

    node ./test/test-node-vm.js

  • CDP API

    • 开启Node调试
    • 使用CDP的覆盖率接口开启和收集覆盖率数据
    • 参见例子:

    node --inspect=9229 ./test/test-node-cdp.js

  • Node Debugging + CDP + NODE_V8_COVERAGE + V8 API

    • 如果启动了一个Node服务,可以手动调用v8.takeCoverage()接口来保存覆盖率数据,开启Node调试就可以远程通过CDP连接的Runtime.evaluate,来调用这个接口.
    • 参见koa的例子:

    node ./test/test-node-koa.js

  • Child Process + NODE_V8_COVERAGE