The checkly sync-playwright command synchronizes your Playwright configuration (playwright.config) with your Checkly project configuration (checkly.config). Keeping your configuration in sync ensures consistency between local testing and cloud monitoring environments.
The applied playwrightConfig configuration is applied to all Browser and MultiStep Checks defined in your Checkly project.
Before using checkly sync-playwright, ensure you have:
  • An initialized Checkly CLI project
  • A checkly.config.ts or checkly.config.js configuration file
  • A playwright.config.ts or playwright.config.js

Usage

Copy supported Playwright configuration settings to your Checkly config automatically.
Terminal
npx checkly sync-playwright

Supported Playwright Configuration

The sync-playwright command parses your existing playwright.config file and extracts global, use and expect settings.
playwright.config.ts
export default defineConfig({
  // Global Playwright config (global)
  timeout: 10_000,

  // Settings applied to all tests (use)
  use: {
    trace: 'on-first-retry',
    colorScheme: 'light',
    viewport: { width: 1280, height: 720 },
    actionTimeout: 30000,
    navigationTimeout: 30000,
  },

  // Custom assertion settings (expect)
  expect: {
    timeout: 5000,
  },
});
The following Playwright config values are supported and will be synced:
OptionSupported
timeout
use
expect
testDir
fullyParallel
forbidOnly
retries
workers
reporter
testMatch
testIgnore
outputDir
globalSetup
globalTeardown
projects
webServer