Run tests
Execute visual regression tests and compare against baselines.
Running a visual test captures new screenshots and compares them pixel-by-pixel against the baselines.
Running from the dashboard
All scenarios
From the project header, click "Run all visual tests". Every scenario in the project will be tested across all configured viewports and browsers.
Selected scenarios
From the Tests tab, you can select specific scenarios to test rather than running all of them.
What happens during a test run
Capture
VisualQ's worker launches Playwright, navigates to each scenario's URL, executes click selectors, applies content rules, waits for the configured delay, and takes screenshots at each viewport.
Compare
Each test screenshot is compared pixel-by-pixel against its corresponding baseline. The mismatch percentage is calculated.
Analyze
If AI analysis is enabled and failures are detected, Smart Diff analyzes the visual differences to classify severity and provide explanations.
Report
Results are saved and notifications are sent through configured integrations (Slack, GitHub, webhooks, etc.).
Run status
Each run produces one of these statuses:
| Status | Meaning |
|---|---|
running | Test is in progress |
completed | All comparisons finished, results available |
failed | An error occurred during capture or comparison |
Real-time notifications
When a test run starts and completes, you'll see toast notifications in the dashboard. If you're on a different page, you can navigate to the Tests tab to see results.
Running from CI/CD
You can trigger test runs programmatically:
- GitHub Action:
type: test(default) - REST API:
POST /api/ci/run
See the CI/CD section for details.