To compare two webpage screenshots, capture the page in matching conditions, then compare the new image with an accepted baseline. Playwright Test can create and check screenshot baselines with expect(page).toHaveScreenshot(); its test output includes a visual diff when an image does not match. Review the highlighted areas to decide whether the change is a bug or an intended update before replacing the baseline.
What a screenshot comparison can—and cannot—tell you
A visual comparison checks rendered pixels, not the meaning or correctness of the page. It can show that text moved, a color changed, an image disappeared, or a component shifted. It cannot decide whether that difference is expected. A person still needs to inspect the changed region and approve or reject the result.
Start by deciding what you are comparing: the same page before and after a code change, two deployment environments, or the page across browsers and operating systems. For ordinary regression testing, match the capture setup. If cross-browser behavior is the point, keep a separate expected baseline for each browser and platform rather than treating every rendering difference as a defect.
Make the two captures comparable
For a useful diff, control the conditions that can affect rendering:
Quick wins for a faster PC:
Scan for outdated or missing drivers - takes under a minuteDriver Scan →Repair Windows errors before they cause bigger problemsFix Now →#1 Best Overall
- 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.
- Browser and version: use the same browser build for baseline and subsequent runs.
- Operating system and rendering environment: fonts, native controls, scrollbars, hardware, power source and headless mode can affect screenshots.
- Viewport and scale: keep the viewport dimensions and device scale factor consistent.
- Page state: use the same route, content, account state, scroll position and interaction state.
- Timing: wait for the page to settle and for relevant content to load. Animations, rotating content and live data can create noise.
Playwright notes that screenshot output may vary with the host operating system, browser version, settings, hardware, power source and headless mode. Keep baselines in the same environment as the tests whenever possible. If a project intentionally tests multiple environments, maintain environment-specific baselines.
Compare screenshots with Playwright Test
Playwright Test is a practical option when you already use Playwright and want assertions plus reference images managed with the project. The first run creates a baseline; later runs compare a new capture against it. See the Playwright visual comparisons guide and SnapshotAssertions API for current assertion details.
1. Install and configure a test
In an existing Playwright Test project, add a test such as this. Replace the URL with the page you want to check:
import { test, expect } from '@playwright/test';
test('homepage matches its visual baseline', async ({ page }) => {
await page.setViewportSize({ width: 1280, height: 800 });
await page.goto('http://localhost:3000', { waitUntil: 'networkidle' });
await expect(page).toHaveScreenshot('homepage.png');
});The assertion waits for two consecutive screenshots to match before comparing the final image with the expected one. This reduces failures caused by a page that is still changing at capture time, but it does not make genuinely dynamic content deterministic.
Free tools Windows power users keep installed
One-click scans. No signup required.
Rank #2
- 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.
2. Create the baseline
Run the test once in the environment you intend to use for future comparisons:
npx playwright testOn the first run, Playwright stores the reference screenshot. Review it and keep the generated baseline with the project so teammates and CI can compare against the same accepted image.
3. Run the comparison and inspect the diff
After a page change, run the test again. If the image differs beyond the configured tolerance, the assertion fails and Playwright produces comparison output, including a diff image. Open the test report or image artifacts and inspect the changed area alongside the expected and actual screenshots. A mismatch is a prompt to review, not a verdict that the change is wrong.
4. Update only an approved baseline
If the visual change is intentional and correct, update the stored reference after review:
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Rank #3
- 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 playwright test --update-snapshotsDo not update snapshots simply to make a failing test pass. First determine what changed and whether the new appearance is acceptable.
Reduce noise without hiding real regressions
Use thresholds with reviewed examples
Playwright visual comparisons use pixelmatch and let you configure a pixel-difference threshold or maximum number of changed pixels. These controls can absorb minor rendering variation, but a permissive threshold can also hide small defects. Choose a tolerance by examining representative diffs from your own page and environment; do not assume one value works for every component.
Neutralize known volatile regions
If a specific region changes unpredictably—such as a timestamp or live ticker—use Playwright’s screenshot stylesheet support to hide or neutralize that content during capture. Keep the exclusion narrow. Broadly masking a region can conceal a layout break or missing content that the test should catch. The screenshot assertion options are documented in the visual comparisons guide.
Separate intentional environment differences
Fonts, native controls and scrollbars can differ across browsers and operating systems. When those differences are expected or are specifically under test, compare each browser/platform combination with its own approved baseline. Do not loosen thresholds across the board to make unrelated environments appear identical.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Clear out junk files and repair common Windows errors3Fix the driver behind crashes, sound loss and screen glitchesRank #4
- 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
Choose a workflow that fits your team
Playwright, Chromatic and Percy address different testing and review needs. ScreenshotNeo is a screenshot API and MCP server, useful when you need to capture pages programmatically rather than manage visual-test baselines.
| Tool | Good fit | What to account for |
|---|---|---|
| ScreenshotNeo | Programmatic website screenshots through an API or MCP server. Clean shots are billed; bot checks, blank pages, timeouts, failed loads and cache hits are not. | It captures pages; the comparison and approval workflow is yours to build or connect. |
| Playwright Test | Teams already using Playwright that want local assertions and repository-managed reference images. | Your team maintains baselines and capture consistency in its test environment. |
| Chromatic | Teams seeking hosted snapshot storage, interactive review and Playwright integration. | It adds an external service workflow. Chromatic documents archived page assets and a hosted review app; check its current plan and program terms separately. |
| Percy | Teams seeking hosted visual diffs and configurable browser/OS rendering. | Browser and OS variations can legitimately change fonts, controls or scrollbars, so interpret cross-browser diffs in context. |
Chromatic documents its Playwright integration and hosted review workflow, along with its snapshot and pixel-diff workflow. BrowserStack describes Percy visual testing and its browser and OS configuration. Compare options by baseline storage and upkeep, review tools, debugging context, integration with current tests, supported environments and how accepted changes are recorded.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Or skip the browser setup
ScreenshotNeo can capture a page with one GET request. For example, save a WebP screenshot of the page under test:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpSee the ScreenshotNeo API documentation for request options. It can accept cookie/consent banners and remove more than 60 known consent platforms, newsletter popups and chat widgets before capture; each step can be turned off. Bot checks, blank pages, timeouts, failed loads and cache hits cost nothing, and the response identifies page verdict and billing status in headers. An MCP server gives AI agents tools for screenshots, page information and PDF capture. The free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots.
Sign up for ScreenshotNeo’s free plan to try 1,000 screenshots a month with no card.
Best Value
- 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.
Troubleshooting visual test failures
- The test fails on CI but passes locally: check browser version, operating system, headless mode, fonts, viewport and device scale factor. Run baseline creation and comparison in the same environment, or maintain separate baselines for intentionally different environments.
- The diff highlights content that changes on every run: identify whether it is animation, live data or a late-loading element. Stabilize the page state or narrowly hide that region with a screenshot stylesheet.
- The screenshot is captured before the page is ready: wait for the relevant content or selector, and make page data deterministic.
networkidlecan help for pages that become idle, but ongoing requests may prevent it from being a suitable readiness condition. - Too many tiny differences fail the assertion: inspect the diff, verify the environment first, then adjust the threshold or changed-pixel limit cautiously. Avoid increasing tolerance before ruling out a real shift.
- A large change appears after a legitimate redesign: review the affected regions and expected screenshot, then update the baseline only after approval.
- Cross-browser screenshots disagree: first decide whether the test is checking regressions within one browser or intended behavior across browsers. Use matching baselines for the former and environment-specific baselines for the latter.
Frequently asked questions
Does Playwright create an image showing what changed?
Yes. When a screenshot assertion fails, Playwright’s test output includes visual comparison artifacts such as a diff image so you can locate pixel-level changes.
Can I compare an element instead of the whole page?
Yes. Playwright screenshot assertions can target an element, which is useful when a test concerns one component and the rest of the page is irrelevant.
Should I use a screenshot diff for cross-browser testing?
Use it, but interpret the result against the browser and operating system being tested. Rendering differences may be expected; environment-specific baselines make them easier to distinguish from regressions.
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Crashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteQuick 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.
