cypress-istanbul

Saves the code coverage collected from instrumented code

Install

npm install -D cypress-istanbul

and its peer dependencies

npm install -D nyc istanbul-lib-coverage cypress

Add to your cypress/support/index.js file

import 'cypress-istanbul/support'

Register tasks in your cypress/plugins/index.js file

module.exports = (on, config) => {
  on('task', require('cypress-istanbul/task'))
}

If your application is loaded Istanbul-instrumented source code, then the coverage information will be automatically saved into .nyc_output folder and a report will be generated after the tests finish (even in the interactive mode). Find the HTML report in the coverage folder.

Instrument unit tests

If you test your application code directly from specs you might want to instrument them and combine unit test code coverage with any end-to-end code coverage (from iframe). You can easily instrument spec files using babel-plugin-istanbul for example. Put the following in cypress/plugins/index.js file to use .babelrc file

const browserify = require('@cypress/browserify-preprocessor')

module.exports = (on, config) => {
  on('task', require('cypress-istanbul/task'))

  // tell Cypress to use .babelrc when bundling spec code
  const options = browserify.defaultOptions
  options.browserifyOptions.transform[1][1].babelrc = true
  on('file:preprocessor', browserify(options))
}

Install the plugin

npm i -D babel-plugin-istanbul

and set in your .babelrc file

{
  "plugins": ["istanbul"]
}

Now the code coverage from spec files will be combined with end-to-end coverage.

Examples

• Demo battery app branch "bundle"
• Read "Code Coverage by Parcel Bundler" blog post

License

This project is licensed under the terms of the MIT license.