puppeteer-to-istanbul

Puppeteer to Istanbul

Convert coverage from the format outputted by puppeteer to a format consumable by Istanbul.

Usage

To Output Coverage in Istanbul Format with Puppeteer

1. install puppeteer, npm i puppeteer --save.

2. install puppeteer-to-istanbul, npm i puppeteer-to-istanbul --save.

3. run your code in puppeteer with coverage enabled:

   (async () => {
     const pti = require('puppeteer-to-istanbul')
     const puppeteer = require('puppeteer')
     const browser = await puppeteer.launch()
     const page = await browser.newPage()
   
     // Enable both JavaScript and CSS coverage
     await Promise.all([
       page.coverage.startJSCoverage(),
       page.coverage.startCSSCoverage()
     ]);
     // Navigate to page
     await page.goto('https://www.google.com');
     // Disable both JavaScript and CSS coverage
     const [jsCoverage, cssCoverage] = await Promise.all([
       page.coverage.stopJSCoverage(),
       page.coverage.stopCSSCoverage(),
     ]);
     pti.write(jsCoverage)
     await browser.close()
   })()
   

To Run Istanbul Reports

1. install nyc, npm i nyc -g.

2. use nyc's report functionality:

   nyc report --reporter=html
   

puppeteer-to-istanbul outputs temporary files in a format that can be consumed by nyc.

see istanbul for a list of possible reporters.

Contributing

If you see an issue with Puppeteer to Istanbul, please open an issue! If you want to help improve Puppeteer to Istanbul, please fork the repository and open a pull request with your changes.

Make sure to review our contributing guide for specific guidelines on contributing.

Changelog

1.2.2 (2018-03-03)

Bug Fixes

• we need to create the .nyc_output folder if it doesn't exist (17c9e69)

<a name="1.2.1"></a>