Playwright to Istanbul

This is a fork of istanbuljs/puppeteer-to-istanbul, if you are using puppeteer, i would suggest using original library. it has been modified and added a function to manually passing a page to a function and setting the coverage.

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

Usage

To Output Coverage in Istanbul Format with Playwright

1. install playwright, npm init playwright@latest.

2. install playwright-to-istanbul, npm i -D playwright-to-istanbul.

3. run your code in playwright with coverage enabled:

   (async () => {
     const pti = require('playwright-to-istanbul')
     const { chromium } = require('playwright');
     const browser = await chromium.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, ...cssCoverage], { includeHostname: true , storagePath: './.nyc_output' })
     await browser.close()
   })()

To Check Istanbul Reports

1. install nyc, npm i nyc -g.

2. use nyc's report functionality:

   nyc report --reporter=html

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

see istanbul for a list of possible reporters.

Contributing

The best way to get started with Playwright to Istanbul is by installing it for yourself and running tests. PTI requires the most recent build of v8toistanbul to function properly, so start by running npm install.

Next, ensure that all tests are passing before continuing by running npm test (or equivalently, npm t). This should generate a report that gives the same coverage as seen on this README.

Note that a majority of the tests run against pre-generated fixtures, or JSON snippets, that come from Playwright's raw output. These are located in the \test\fixtures area. To generate one of your own, write or use one of the scripts in the test area test\sample_js, and run bin/puppeteer-js-runner.js through node, like so:

node bin/puppeteer-js-runner.js --file=/test/sample_js/sample2.js.

If you see an issue with Playwright to Istanbul, please open an issue! If you want to help improve Playwright 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.