playwright-test-coverage-native

Measure test coverage with Playwright. Its only dependency is @playwright/test — unlike its alternatives, playwright-test-coverage-native uses Playwright's built-in coverage functionality without Istanbul.

Installation

Using NPM:

1npm i -D playwright-test-coverage-native

Using PNPM:

1pnpm i -D playwright-test-coverage-native

Configuration

Add coverageDir to playwright.config.ts to set where coverage data should be written to. For example,

1import { defineConfig, devices } from "playwright-test-coverage-native";
2
3// See https://playwright.dev/docs/test-configuration.
4export default defineConfig({
5  projects: [
6    {
7      name: "chromium",
8      use: {
9        ...devices["Desktop Chrome"],
10        coverageDir: './coverage/tmp',  // output location for coverage data
11        coverageSrc: './src',           // filter coverage data for only files in ./src (optional)
12        // one of: '@fs', 'localhosturl'. Sadly you'll just have to play around to see which one works
13        coverageSourceMapHandler: '@fs'
14      },
15    },
16  ],
17});

[!NOTE]
Coverage APIs are only supported on Chromium-based browsers.

Usage

playwright-test-coverage-native is a drop-in replacement for @playwright/test. Edit the import of your test files like this:

1-import { test, expect } from '@playwright/test';
2+import { test, expect } from 'playwright-test-coverage-native';

If you're brave, you can do the changes in bulk:

1# using GNU coreutils
2find -type f -name '*.test.?s' -exec sed -i -e 's#@playwright/test#playwright-test-coverage-native#' \;

Post-processing

Install c8.

After running playwright test -c playwright.config.ts, run c8 report to print a summary of the coverage. c8 report is also used to convert to various formats, see c8 report --help for more options.

Alternatives

[!NOTE]
V8 code coverage can be inaccurate due to JavaScript code transformation and source maps, in which case alternatives (which use istanbul) may be preferable.

• https://github.com/anishkny/playwright-test-coverage (requires babel-plugin-istanbul instrumentation)
• https://github.com/mxschmitt/playwright-test-coverage (requires vite-plugin-istanbul)