For reliable visual comparisons, capture the same page state in the same browser and operating-system environment, with a fixed viewport, scale, and capture scope. In Playwright, use toHaveScreenshot() for a screenshot assertion that waits for two consecutive captures to match before comparing with the baseline. A screenshot records how a page looks; use browser rendering diagnostics and performance traces to investigate when and why it repaints, shifts, or drops frames.
What makes website screenshots consistent?
A screenshot is the output of a rendering environment, not just a URL. Playwright identifies host operating system, browser version, settings, hardware, power source, and headless mode as sources of variation. Fonts and browser-platform rendering can also make snapshots differ. Its guidance is to run tests in the same environment where the baseline was generated: Playwright visual comparisons.
Define and record the comparison target: URL, application state, viewport width and height, browser project, operating system or container image, and whether the capture is a viewport, full page, or element. If cross-browser or cross-platform coverage is required, treat each browser/platform combination as its own project with its own baseline rather than treating its rendering differences as noise.
Set up a repeatable Playwright screenshot
In a Playwright Test project, set the viewport, navigate to the page, wait for the application state you need, and assert against a named screenshot. Replace the example readiness condition with a reliable signal for your application; there is no universal fixed delay that guarantees a page is ready.
Free tools Windows power users keep installed
One-click scans. No signup required.
#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.
import { test, expect } from '@playwright/test';
test('captures a stable page state', async ({ page }) => {
await page.setViewportSize({ width: 1280, height: 800 });
await page.goto('https://example.com');
await page.getByRole('main').waitFor();
await expect(page).toHaveScreenshot('example.png', {
animations: 'disabled',
caret: 'hide',
scale: 'css',
});
});This is an illustrative pattern, not a tested recipe for every site. The readiness condition should represent the content or component whose appearance matters. Playwright’s toHaveScreenshot() retries until two consecutive page screenshots match, then compares the last capture with the expected image: screenshot assertion options.
Keep baseline and follow-up environments aligned
Run baseline creation and later comparisons in the same CI image, browser version, and headless configuration where practical. Avoid comparing a local baseline from a different OS or browser setup unless cross-environment variation is what you intend to test. For deliberate platform coverage, keep separate baselines per configured project.
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.
Wait for application state, not an arbitrary pause
Wait for a meaningful condition, such as the relevant component becoming visible and populated or a loading indicator disappearing. An arbitrary timeout can be too short on a slow run and waste time on a fast one. The right readiness signal is application-specific; select one that means the screenshot target is actually ready.
Control motion and volatile page content
Animations, blinking carets, clocks, rotating promotions, and other changing content can make otherwise identical captures differ. Decide explicitly whether each changing region is part of what the test should verify.
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 matchPC 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 & 11Rank #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.
- Disable animation when motion is not under test. Playwright’s screenshot APIs support
animations: 'disabled'. Finite animations are fast-forwarded and infinite animations are canceled to their initial state for capture, then restored. Screenshot assertions default to disabled animations. - Hide a blinking caret. The page screenshot option defaults to hiding the caret; set
caret: 'hide'explicitly in an assertion to make the policy visible in the test. - Mask or alter only genuinely volatile regions. A screenshot stylesheet can hide or modify dynamic elements; use it for content such as a changing clock only when that content is outside the test’s purpose. Masking means that region is no longer being checked, so document the choice in the test and avoid masking layout, text, or rendering behavior you want to catch.
See Playwright’s page screenshot options and visual comparison guidance for the current options and behavior.
Choose capture scope and pixel scale
Keep the capture type consistent between the baseline and each comparison. Choose the smallest scope that answers the debugging question, unless off-screen content is part of the issue.
Rank #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
- Viewport: best for a particular screen state and viewport size.
- Full page: includes below-the-fold layout, useful when the issue may occur farther down the document.
- Element: isolates a component when the problem is confined to it.
Playwright’s screenshot scale option controls output pixel dimensions. 'css' produces one image pixel per CSS pixel; 'device' produces one image pixel per device pixel and is the page.screenshot() default. On a high-DPI device, device scale can produce a larger image. Select deliberately and keep it fixed for comparable output. Details are in the page screenshot API.
Compare screenshots and review baseline changes
Playwright’s visual comparison workflow creates reference screenshots on an initial run and compares later runs against them. When a legitimate design change requires new references, update them deliberately with:
The Tool Desk
Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →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.
npx playwright test --update-snapshotsDo not update snapshots automatically just to clear a failure. First review whether the visual difference is intended; otherwise a real regression can become the new accepted baseline. Playwright also supports configurable pixel-difference thresholds and screenshot styles. A looser threshold can reduce sensitivity to small noise, but may also let small genuine regressions pass, so use it only with an explicit tolerance in mind. See Playwright’s visual comparison guide.
Use rendering diagnostics to investigate performance
A still screenshot can show what looks wrong, but cannot establish when a visual change occurred or what caused it. Capture a performance trace or use Chrome DevTools Rendering tools alongside screenshots to investigate repainting, layout instability, and frame delivery. These tools support diagnosis; by themselves they do not prove a root cause, and comparisons still depend on capture conditions, emulation, and workload.
Inspect repainting, layout shifts, and frames
- Paint flashing: highlights repainted regions in green. Repeated flashing can help identify areas being repainted during an interaction or animation.
- Layout-shift regions: briefly highlights shifted regions in purple after a refresh.
- Frame rendering stats: show an FPS estimate and distinguish successfully rendered, partially presented, and dropped frames.
- Other rendering diagnostics: DevTools also exposes painting events, layer borders, and scrolling-performance information.
Chrome’s Rendering performance reference describes these options. The page lists Core Web Vitals guidance of LCP within 2.5 seconds, INP of 200 milliseconds or less, and CLS of 0.1 or less; that documentation was last updated April 13, 2022, so consult current Web Vitals guidance before relying on those thresholds.
Common causes of screenshot differences
| Symptom | Likely cause | What to check |
|---|---|---|
| Text, spacing, or antialiasing differs across machines | Different OS, fonts, browser version, settings, hardware, or headless mode | Use the baseline environment for comparison, or maintain separate platform-specific baselines. |
| Only animated or promotional regions differ | Capture occurred at different animation frames or content states | Disable nonessential animation or locally mask/alter volatile content; do not hide regions the test is meant to verify. |
| Screenshot is intermittently incomplete | Capture ran before the relevant application state was ready | Wait for a specific content or component readiness condition rather than choosing a generic delay. |
| Image dimensions or pixel diffs change after moving to a high-DPI setup | Device-pixel scale differs from CSS-pixel scale | Set scale explicitly and use the same value for baseline and comparison. |
| Full-page result differs from a viewport capture | Capture scope changed, or below-the-fold content is relevant | Keep viewport, full-page, or element scope consistent; choose full-page when off-screen layout is under investigation. |
| A visual assertion fails after a design update | Either an intended change or a genuine regression | Review the diff before updating the reference with npx playwright test --update-snapshots. |
Or skip the browser setup
ScreenshotNeo is a website screenshot API and MCP server. For a one-call capture, use cURL:
Quick Recap
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webpSee the ScreenshotNeo API documentation for setup and request options. Cookie banners are accepted and removed before capture, along with supported consent platforms, newsletter popups, and chat widgets; each cleanup step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers report the page verdict and billing status. An MCP server provides take_screenshot, get_page_info, and capture_pdf for AI agents and MCP clients. The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 shots. Sign up for ScreenshotNeo’s free plan.
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.
