Skip to main content

Checkly

Checkly is a Playwright-native test reporting platform. Unlike CI-only tools, it stores screenshots, traces, and console output alongside test results — making failures easy to investigate without leaving your browser.

Checkly test results dashboard

Setup

1. Install the reporter

npm install --save-dev @checkly/playwright-reporter

2. Add the reporter to your config

Import createChecklyReporter and add it to the reporter array in mobilewright.config.ts:

import { defineConfig } from 'mobilewright';
import { createChecklyReporter } from '@checkly/playwright-reporter';

export default defineConfig({
reporter: [
['list'],
createChecklyReporter({
sessionName: 'Smoke suite',
}),
],
});

3. Set credentials

The reporter reads your Checkly credentials from environment variables:

export CHECKLY_API_KEY=<your-api-key>
export CHECKLY_ACCOUNT_ID=<your-account-id>

Then run your tests as usual:

npx mobilewright test

Results are uploaded automatically at the end of the run.

4. View results

Open on Test Sessions on the left sidebar, and you will see the uploaded report.

Configuration

Pass options to createChecklyReporter() for full IDE intellisense:

OptionTypeDescription
sessionNamestringName shown in the Checkly dashboard for this run
outputDirstringDirectory for report output. Defaults to Playwright's outputDir
dryRunbooleanGenerate the report locally without uploading
verbosebooleanShow worker stdout/stderr in the terminal. Defaults to true
showProgressbooleanPrint real-time test progress. Defaults to true
showSummaryTablebooleanPrint a per-project summary table at the end. Defaults to true
scrubbingScrubbingOptions | falseScrub secrets from reports. Auto-detects common patterns by default

CI example (GitHub Actions)

- name: Run Mobilewright tests
env:
CHECKLY_API_KEY: ${{ secrets.CHECKLY_API_KEY }}
CHECKLY_ACCOUNT_ID: ${{ secrets.CHECKLY_ACCOUNT_ID }}
run: npx mobilewright test