What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add Percy to the Playwright browser tests in your React project by installing @percy/cli and @percy/playwright, placing percySnapshot(page, 'name') calls at the states you want to review, and running the existing Playwright command through npx percy exec. Playwright continues to test behavior; Percy captures selected rendered states for visual comparison.

How the Percy and Playwright workflow fits together

Playwright Test runs browser tests against your React app. Percy adds visual snapshots to selected points in those tests, then compares them with approved baselines so visual differences can be reviewed. A snapshot is not a replacement for an assertion: keep assertions that verify what the app does, and use Percy to review how it looks.

This setup uses the Playwright page in a browser test. It does not require a separate Percy React SDK in the documented workflow.

1. Check that Playwright Test runs

In an existing React project, keep your current app structure and use the Playwright installation appropriate to that project. If Playwright is not installed, its initializer can set up a new project or add Playwright to an existing one:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.
npm init playwright@latest

Follow the prompts, then confirm the test command works:

npx playwright test

Resolve existing test or browser-installation failures before adding Percy. That gives you a working baseline for distinguishing Playwright problems from Percy integration problems.

2. Install Percy

From the project root, install the Percy CLI and Playwright integration as development dependencies:

npm install --save-dev @percy/cli @percy/playwright

The CLI will wrap the test command, and the Playwright package provides the snapshot helper. The documented setup example is not a versioned compatibility matrix; check the current package documentation if you need to validate specific package versions or a production rollout.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

3. Add snapshots to the React states worth reviewing

Import percySnapshot in a Playwright test and call it after navigation and any actions needed to reach the state. For example:

import { test, expect } from '@playwright/test';
import { percySnapshot } from '@percy/playwright';

test('shows the login error state', async ({ page }) => {
  await page.goto('/login');

  await page.getByLabel('Email').fill('not-an-account@example.com');
  await page.getByLabel('Password').fill('incorrect-password');
  await page.getByRole('button', { name: 'Sign in' }).click();

  await expect(page.getByText('Invalid email or password')).toBeVisible();
  await percySnapshot(page, 'Login – Error State');
});

The example assumes your app has those labels, button text, and error message; adapt the locators and expected text to the actual UI. The important sequence is to navigate, perform the relevant interaction, establish that the intended state is present, and then capture it.

Choose snapshot points deliberately

  • Capture a page’s initial state when its appearance is important.
  • Capture post-interaction states such as validation errors, expanded menus, or a completed flow when those states matter to users.
  • Use descriptive snapshot names so reviewers can identify the state without inferring it from test code.

Wait for the UI that matters, not an arbitrary delay

Before capturing, wait for the actual user-visible readiness condition: for example, an expected heading to appear or a loading indicator to disappear. Network work, animations, and lazy-loaded content can otherwise make captures inconsistent. A fixed sleep may hide timing problems or waste time; use a condition that reflects when the specific screen is ready. Minimize or stabilize changing content where possible so incidental timestamps, rotating content, or other dynamic regions do not overwhelm meaningful changes.

4. Run Playwright through Percy

Wrap the test command you already use with Percy CLI:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.
npx percy exec -- npx playwright test

Percy needs the project token to authenticate snapshot uploads. Make it available to the wrapped process using the current instructions for your Percy project, preferably through your local environment or CI secret management. Do not commit the token to source control. The setup example establishes the wrapper pattern, but not the current account-screen steps or a universal token-variable name; follow the project-specific current guidance for those details.

For a repeatable project command, add a script to package.json alongside your existing test script:

{
  "scripts": {
    "test:e2e": "playwright test",
    "test:visual": "percy exec -- playwright test"
  }
}

Then run:

npm run test:visual

This assumes the project has the local Playwright and Percy executables installed as dependencies. Keep the existing non-Percy test command available for runs where you only need behavioral tests.

5. Review differences without weakening behavior checks

Use the test result and visual review for different questions. A failed assertion means a tested behavior or outcome did not meet the test’s expectation. A Percy difference means the rendered appearance differs from the approved baseline and needs inspection. Review each difference; fix an unintended UI change, or approve a baseline update when the appearance change is intentional. Do not update baselines simply to make a run pass without understanding the change.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshooting

Playwright passes, but Percy snapshots do not upload

Check that the command is running inside percy exec and that the Percy project token is available to that process. Verify token setup against the current Percy project instructions, and keep secrets out of committed files.

The snapshot shows a loading or incomplete state

The capture may run before the app’s relevant work finishes. Add a Playwright wait for the actual ready state, such as a visible page heading or completed result, and account for lazy-loaded content or animations that affect the screen.

Visual differences appear on every run

Look for unstable content or timing: timestamps, randomized data, rotating content, animation, or requests that finish at varying times can create noisy comparisons. Stabilize test data where practical and wait for the specific state under test rather than relying on a broad, arbitrary delay.

The Percy command fails before tests start

Run npx playwright test by itself first. If that fails, resolve the Playwright configuration, test, or browser setup issue before diagnosing Percy. If the plain command works but the wrapped command does not, check the Percy CLI installation and token availability.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.

A baseline changes after a UI update

Inspect the difference against the intended design and the behavioral assertions. If the new appearance is expected, approve the updated baseline through the review workflow for your Percy project; otherwise, correct the UI or test setup instead.

Or skip the browser setup

ScreenshotNeo is a website screenshot API and MCP server, not a Percy visual-regression baseline and review workflow. If your goal is to request a screenshot of a URL without wiring up a browser test, one GET request can return an image or PDF. For example, save a WebP screenshot of your deployed React page:

curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://your-site.example -o shot.webp

See the ScreenshotNeo API documentation for request options. It removes cookie banners, newsletter popups, and chat widgets before capture; bot checks, blank pages, and failed loads are never billed; and its MCP server lets AI agents take screenshots. The free plan includes 1,000 screenshots a month with no card, and paid plans start at $5 for 3,000. Sign up for free.

Frequently Asked Questions

Does Percy require a separate React package?

Not for this Playwright browser-test workflow; the snapshot helper receives the Playwright page.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Can a Percy snapshot replace a Playwright assertion?

No. Assertions check behavior and outcomes; snapshots support review of rendered appearance.

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.