@cypress/instrument-cra

Little module for CRA applications to instrument code without ejecting react-scripts


Keywords
cra, react-scripts, istanbul, code-coverage, cypress, cypress-io
License
MIT
Install
npm install @cypress/instrument-cra@1.4.0

Documentation

@cypress/instrument-cra renovate-app badge CircleCI

Little module for CRA applications to instrument code without ejecting react-scripts

Install and use

yarn add @cypress/instrument-cra

Then change your npm start script to require this module before starting the dev server

{
  "scripts": {
    "start": "react-scripts -r @cypress/instrument-cra start",
  }
}

This module assumes standard Create-React-App v3 JavaScript application with source files in the "src" folder.

When the app starts with yarn start, you should see the coverage information under window.__coverage__ information.

Coverage object

The instrumentation is done using Istanbul.js via babel-plugin-istanbul and is compatible with @cypress/code-coverage plugin.

Exclude files

If you want to exclude files from coverage, for example src/serviceWorker.js, add an object named nyc to package.json following the nyc CLI configuration.

{
  "nyc": {
    "exclude": "src/serviceWorker.js"
  }
}

Debugging

Run with environment variable DEBUG=instrument-cra to see the verbose logs

License

MIT License, see LICENSE