The Tool Desk
Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →To add Percy to a Playwright project, install Percy’s CLI and Playwright SDK, connect a Percy project token, and run your tests through Percy. If your tests already use Playwright’s toHaveScreenshot(), Percy offers a drop-in integration; otherwise, call percySnapshot() at the points you want to review.
Choose how Percy should capture your Playwright tests
Percy’s Playwright setup has two main routes. The drop-in route collects existing toHaveScreenshot() captures with minimal test changes. The explicit SDK route lets test code choose exactly where Percy snapshots are taken. If you want to see a Percy build before touching your own suite, start with the official Percy getting-started guide and its sample project.
As an Amazon Associate I earn from qualifying purchases.
| Route | Use it when | Test changes |
|---|---|---|
toHaveScreenshot() drop-in |
Your Playwright tests already use Playwright screenshot assertions. | Add the Percy drop-in import; existing screenshot calls are picked up. |
Explicit percySnapshot() |
You want to decide precisely where to capture snapshots or do not use toHaveScreenshot(). |
Add Percy snapshot calls to the test script. |
Prerequisites for the drop-in integration
The Percy Playwright reference lists these minimum versions for the drop-in route: Node.js 18 or later, @playwright/test 1.60 or later, @percy/cli 1.32.6 or later, and @percy/playwright 1.1.2 or later. These requirements can change, so check the current Percy Playwright reference if installation or compatibility fails.
Recommended Free Tools
Route 1: send existing toHaveScreenshot() tests to Percy
Install and load the drop-in
-
From your project directory, install the CLI and Playwright integration:
#1 Best Overall
Sale
Philips 24 Inch Computer Monitor FHD 100Hz VA VESA Flicker-Free, 241V8LB- CRISP CLARITY: This 23.8″ Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
- INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
- THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
- WORK SEAMLESSLY: This sleek monitor is virtually bezel-free on three sides, so the screen looks even bigger for the viewer. This minimalistic design also allows for seamless multi-monitor setups that enhance your workflow and boost productivity
- A BETTER READING EXPERIENCE: For busy office workers, EasyRead mode provides a more paper-like experience for when viewing lengthy documents
npm install --save-dev @percy/cli @percy/playwright -
Load the drop-in at the start of your Playwright configuration, before the configuration is defined. For a CommonJS
playwright.config.js:require('@percy/playwright/dropin');
const { defineConfig } = require('@playwright/test');Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.module.exports = defineConfig({
// existing configuration
}); -
Set the token for the Percy project and run the test suite through the Percy CLI:
Rank #2
Philips 22 Inch Computer Monitor FHD 100Hz VA VESA Flicker-Free, 221V8LB- CRISP CLARITY: This 22 inch class (21.5″ viewable) Philips V line monitor delivers crisp Full HD 1920x1080 visuals. Enjoy movies, shows and videos with remarkable detail
- 100HZ FAST REFRESH RATE: 100Hz brings your favorite movies and video games to life. Stream, binge, and play effortlessly
- SMOOTH ACTION WITH ADAPTIVE-SYNC: Adaptive-Sync technology ensures fluid action sequences and rapid response time. Every frame will be rendered smoothly with crystal clarity and without stutter
- INCREDIBLE CONTRAST: The VA panel produces brighter whites and deeper blacks. You get true-to-life images and more gradients with 16.7 million colors
- THE PERFECT VIEW: The 178/178 degree extra wide viewing angle prevents the shifting of colors when viewed from an offset angle, so you always get consistent colors
PERCY_TOKEN=<your-project-token> npx percy exec -- npx playwright test
The drop-in applies Percy to each toHaveScreenshot() call, so this route does not require edits to the test files themselves. The example command uses POSIX-style environment-variable syntax; in CI, configure PERCY_TOKEN in the job’s secret/environment settings and run npx percy exec -- npx playwright test.
Route 2: add explicit Percy snapshots
Use explicit snapshots when a script needs to choose its capture points directly. The JavaScript integration guide documents installing the CLI and SDK, creating a Percy project, exporting its token as PERCY_TOKEN, and running the test command with percy exec.
Free tools Windows power users keep installed
One-click scans. No signup required.
Install, add a capture, and run
-
Install the packages:
npm install --save-dev @percy/cli @percy/playwright -
In an existing Playwright test or script, import the snapshot function, navigate to the page, then capture it. For example:
const { chromium } = require('playwright');
const percySnapshot = require('@percy/playwright');Rank #3
Dell 24 Monitor - SE2426H - 23.8-inch FHD (1920x1080) 144Hz 1ms Display, in-Plane Switching (IPS) Technology, AMD FreeSync™, TÜV 3-Star 2X HDMI, Tilt- Clear visuals. Fluid motion: A 144Hz refresh rate and 1ms MPRT deliver smooth, tear‑free motion across work, gaming, and streaming for clearer, more fluid viewing.
- Eye comfort: TÜV Rheinland 3‑star* certification reduces harmful blue light while preserving stunning color quality without compromise. *TÜV Rheinland 3-star eye comfort certification.
- Wide viewing angle: Get consistent views across a wide 178° /178° viewing angle.
- In-Plane Switching (IPS): See excellent color accuracy and consistency across wide viewing angles with In-plane Switching (IPS) technology.
- Ultra-thin bezels: Maximize your viewing experience with thin bezels.
(async () => {
const browser = await chromium.launch();
const page = await browser.newPage();
await page.goto('https://example.com');
await percySnapshot(page, 'Example Site');
await browser.close();
})();Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy. -
Run that script inside Percy, substituting your project’s actual test command or script path:
PERCY_TOKEN=<your-project-token> npx percy exec -- node path/to/test.js
Choose snapshot names that help reviewers identify the page or state in the Percy build. For the SDK’s documented setup and any current project-creation flow, see Percy’s JavaScript integration guide. A BrowserStack-hosted browser or Automate configuration is not required to understand or implement this basic SDK flow; the guide describes hosted configuration as an available project path.
Configure the Percy token safely
PERCY_TOKEN is a write-only API token unique to a Percy project. BrowserStack says it should be kept secret in its Percy CI/CD documentation. Do not commit it to source code, a Playwright config, or a checked-in environment file.
Rank #4
- CURVED FOR ENHANCED ENGAGEMENT: An immersive viewing experience with a curved monitor that wraps more closely around your field of vision; It creates a wider view, enhancing depth perception and minimizing peripheral distraction
- SMOOTH PERFORMANCE FOR SEAMLESS CONTENT: Stay in the action when playing games, watching videos, or working on creative projects; The 100Hz refresh rate reduces lag and motion blur so you don't miss a thing in fast-paced moments¹
- MORE GAMING POWER: Gain the edge with optimizable game settings; Color and image contrast can be adjusted to see scenes more vividly and spot enemies hiding in the dark; Game Mode adjusts any game to fill the screen so you can view every detail²
- KEEP IT EASY ON THE EYES: Care for your eyes and stay comfortable, even during long sessions; Advanced eye comfort technology certified by TÜV reduces eye strain by minimizing blue light and reducing irritating screen flicker²
- INCREASED VERSATILITY: Connect to more; Plug devices straight into your monitor for increased flexibility, making your computing environment even more convenient
- Local runs: set the token in your shell environment or use the POSIX inline form shown in the commands.
- CI: store it as a protected secret and expose it to the Percy test step as
PERCY_TOKEN. - Multiple projects: use the token for the Percy project receiving that suite’s snapshots.
Run Percy in CI and collect parallel snapshots
For most CI jobs, wrap the Playwright command with percy exec. Percy’s CI/CD guide says its builds can collect snapshots from parallelized test environments, including multiple processes or machines, into the same build.
If your environment cannot wrap the test command, the guide documents starting and stopping the CLI around it instead:
npx percy exec:start
npx playwright test
npx percy exec:stop
Keep the start, test, and stop operations in the same CI job/build context so Percy can associate the collected snapshots with the intended build. Protect the token in either workflow.
Review Percy builds and manage baselines
A passing Playwright run is not proof that the UI remained visually unchanged. With the drop-in integration, the Playwright check can pass while Percy presents the visual change for review. Treat inspecting and approving the Percy build or baseline as part of the workflow, rather than assuming a green test command means every page looks the same.
Best Value
- 【INTEGRATED SPEAKERS】Whether you're at work or in the midst of an intense gaming session, our built-in speakers provide rich and seamless audio, all while keeping your desk clutter-free.
- 【EASY ON THE EYES】 Protect your eyes and enhance your comfort with Blue-Light Shift technology. This feature reduces harmful blue light emissions from your screen, helping to alleviate eye strain during long hours of use and promoting healthier viewing habits.
- 【WIDEN YOUR PERSPECTIVE】Our sleek minimal bezel design ensures undivided attention. The nearly bezel-free display seamlessly connects in a dual monitor arrangement, delivering an unobstructed view that lets you focus on more at once, completely distraction-free.
The Playwright reference also documents a baseline setup command for projects that meet its stated conditions. It is not a universal shortcut for every custom setup: the documented path depends on conditions such as using the default configuration file and particular screenshot naming and path settings. Check the conditions in the Playwright integration reference before adopting that baseline path.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Optional Percy configuration
The basic integration needs the packages, a project token, and a Percy-wrapped test command. For tuning snapshots, the CLI can generate a configuration file with percy config:create. Percy’s CLI configuration options cover snapshot widths, minimum height, Percy CSS, asset discovery, hostnames, and uploads. Use only settings your project needs; configuration generation is optional for the basic setup.
Troubleshooting common setup problems
- No Percy build or snapshots appear: confirm the command is running through
npx percy exec --, that the token is available to that process, and that it belongs to the intended Percy project. - The drop-in appears to do nothing: ensure
require('@percy/playwright/dropin')loads before the Playwright configuration, and that the suite actually callstoHaveScreenshot(). The drop-in applies to those calls. - Package or runtime compatibility errors: check Node.js and package versions against the current prerequisites in Percy’s Playwright reference; the documented minimums may change.
- CI cannot use the wrapper: use the documented
percy exec:startandpercy exec:stopsequence around the Playwright command. - Playwright passes but Percy shows a change: review the Percy build and decide whether the visual difference is expected before approving the baseline.
- Baseline setup does not match the project: verify the documented config-file, screenshot naming, and path conditions. Do not assume the baseline command applies to a custom configuration that does not meet them.
- Snapshots from parallel jobs do not land together: verify that jobs are participating in the intended Percy build context and consult the CI/CD guide for the runner pattern.
Or skip the browser setup
If your goal is simply to get a website screenshot from one request rather than add visual snapshots to a Playwright test suite, ScreenshotNeo is a screenshot API and MCP server for developers. A single GET request returns PNG, JPEG, WebP, or PDF; it is an alternative to Percy, not a replacement for Percy’s visual-test build and baseline workflow.
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →For example, save a WebP screenshot of a page with cURL:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webp
See the ScreenshotNeo documentation for API details. Cookie/consent banners, newsletter popups, and chat widgets are removed before capture, with each cleanup step configurable. Bot checks/CAPTCHAs, blank pages, failed loads, timeouts, and cache hits are not billed, and the response identifies page verdict and billing status. Its MCP server provides take_screenshot, get_page_info, and capture_pdf tools for AI agents. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo’s free plan.
Frequently Asked Questions
Can Percy work with Playwright tests that already use `toHaveScreenshot()`?
Yes. The Percy drop-in integration applies to those calls after you install the packages and load the drop-in in the Playwright configuration.
Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchWindows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallDo I need BrowserStack Automate to use Percy with Playwright?
No. The basic setup can use the Percy SDK and CLI with your Playwright tests; the JavaScript guide also describes a hosted-browser project path.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
