Playwright watch is an app that enables visual watch mode for Playwright. Run and visually debug Playwright tests as soon as you hit save.
npm i -D @deploysentinel/playwright-watch @deploysentinel/playwright
@deploysentinel/playwright-watch requires the
@deploysentinel/playwright reporter to be installed to collect run results and
trace telemetry. All test data is collected locally and never sent out when
using this package.
npx pw-watch --reporter @deploysentinel/playwright
Additional arguments will be forwarded to
Note: Only the last test run will be shown in the visual debugger
Specifing Custom File Pattern
By default, the command watches all files matching
**/*.(spec|test).(mjs|mts|ts|js). You can customize the watched file glob by
passing in any number of globs into
When writing tests locally, often you want to fail fast to get results quickly.
You can lower the default test timeout (30s) by setting
--timeout to a lower
Example test timeout to 2 seconds:
npx pw-watch --reporter @deploysentinel/playwright --timeout=2000
This will ensure no test will run longer than 2 seconds. You may need to experiment with an appropriate timeout for your tests. Granular timeout configs (opens in a new tab) can also be set up in Playwright.
Optional: Installing Reporter to Config
To avoid needing to specify
--reporter @deploysentinel/playwright when running
pw-watch, you can
add the DeploySentinel Playwright reporter to your
playwright.config.(js|ts) file (opens in a new tab).
No API keys are needed when running locally.
Afterwards, you can simply just run
Disabling Cross Browser Test Runs
When in watch mode, typically you only want to run the test against 1
configuration (ex. just Chromium). You can use Playwright's
--project flag to
select only a single project to be run, if your test suite usually runs against
npx pw-watch --reporter @deploysentinel/playwright --project=chromium