Use expect(page).toHaveScreenshot() when the contract is rendered appearance, and expect(page).toMatchAriaSnapshot() when the contract is accessible structure. A screenshot compares pixels; an ARIA snapshot compares roles, accessible names, and text. They are complementary, not interchangeable. If a test only needs one value or behavior, a focused assertion is usually clearer than either snapshot type.
What Playwright means by “snapshot”
Playwright uses “snapshot” for several different artifacts. In this comparison, the useful distinction is between a visual screenshot assertion and an ARIA snapshot assertion. Generic toMatchSnapshot() can compare text or binary data, but it is not the same as either an image comparison or an accessibility-tree comparison.
| Artifact | Typical assertion | What is compared | Best use |
|---|---|---|---|
| Visual screenshot | expect(page).toHaveScreenshot() |
Rendered pixels from a page or locator | Layout, styling, typography, spacing and imagery |
| ARIA snapshot | expect(page).toMatchAriaSnapshot() |
A YAML-like representation of the accessibility tree | Roles, accessible names, text and semantic structure |
| Focused assertion | toHaveText(), toHaveValue(), role or URL assertions |
One specified fact or behavior | Small, directly stated requirements |
| Generic snapshot | toMatchSnapshot() |
Text or binary data supplied to the assertion | Value snapshots that are not specifically visual or ARIA checks |
The official references describe screenshot comparisons in the visual-comparisons guide and ARIA checks in the snapshot-testing guide.
When a screenshot assertion is the right contract
Choose a screenshot when a visual change should fail the test. It can protect a complete page or a deliberately scoped locator against changes to geometry, colors, fonts, borders, responsive layout, icons and images.
Do these 3 things before closing this tab:
1Scan for outdated or missing drivers - takes under a minute2Repair Windows errors before they cause bigger problems3Fix the driver behind crashes, sound loss and screen glitches#1 Best Overall
- 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
Page-level example
import { test, expect } from '@playwright/test';
test('checkout page keeps its visual layout', async ({ page }) => {
await page.goto('https://example.com/checkout');
await expect(page).toHaveScreenshot('checkout.png');
});Locator-level example
test('price card keeps its design', async ({ page }) => {
await page.goto('https://example.com/pricing');
await expect(page.locator('[data-testid="pro-card"]'))
.toHaveScreenshot('pro-card.png');
});Use a locator when the page contains unrelated, volatile areas such as timestamps, rotating promotions or user-specific content. A smaller capture generally produces a more intelligible diff and a narrower maintenance obligation.
When an ARIA snapshot is the better choice
Use an ARIA snapshot when the product contract is semantic: a navigation landmark must exist, a button must have an accessible name, a dialog must expose the expected controls, or a list must retain its role and text. This tests what assistive technologies can consume rather than how the page happens to look.
Page and region examples
import { test, expect } from '@playwright/test';
test('navigation exposes the expected structure', async ({ page }) => {
await page.goto('https://example.com');
await expect(page).toMatchAriaSnapshot(`
- navigation:
- link "Home"
- link "Pricing"
- link "Docs"
`);
});
test('dialog keeps its accessible controls', async ({ page }) => {
await page.goto('https://example.com');
const dialog = page.getByRole('dialog');
await expect(dialog).toMatchAriaSnapshot(`
- dialog:
- heading "Delete project"
- button "Cancel"
- button "Delete"
`);
});Scope the template to the smallest meaningful region. A broad page template can create a large diff when an unrelated section moves, while a focused region makes a semantic regression easier to diagnose. The Locator API documents locator-scoped assertions.
Decision framework: appearance, semantics or one fact?
- Visual appearance is the requirement: use
toHaveScreenshot(). - Accessible structure is the requirement: use
toMatchAriaSnapshot(). - Only one value or behavior matters: use a focused assertion such as
toHaveText(),toHaveValue(), a role assertion or a URL assertion. Playwright’s assertions guide lists these alternatives. - Both appearance and semantics can regress independently: combine a scoped screenshot with an ARIA snapshot, accepting that you now review two artifacts and maintain two contracts.
A screenshot cannot prove that a visually attractive control has the correct role or name. An ARIA snapshot cannot tell you that a button is clipped, has the wrong color contrast caused by styling, or is positioned incorrectly. Select the representation that directly expresses the failure you want to prevent.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Stability, timing and environment
Screenshot comparisons wait for a stable result
Playwright’s screenshot assertion takes consecutive captures and waits for two to be identical before comparing the final image with the expected one. Its documented default disables animations for the capture: finite animations are fast-forwarded and infinite animations are canceled, then animation state is restored. These measures reduce noise, but they cannot remove every difference caused by the execution environment.
Rank #2
- 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
Keep the comparison environment consistent
The visual-comparison documentation warns that operating system, browser version, settings, hardware, power source and headless mode can affect rendering. Generate and compare baselines in a consistent environment whenever possible. A baseline produced on one platform can legitimately differ on another even when application code has not changed.
- Pin the browser and Playwright versions used by your CI job.
- Run baseline generation and comparison with the same operating-system image and display settings.
- Control fonts and other installed rendering dependencies.
- Prefer deterministic test data and stable viewport settings.
- Limit screenshots to the page or component that owns the visual contract.
ARIA snapshots have their own maintenance cost
ARIA snapshots are text-like templates, so their diffs are often easier to read than pixel diffs. However, a deliberately broad template can still change substantially after a structural redesign. Keep the scope intentional and include only semantics that matter to the contract.
Creating, storing and updating baselines
First run
When toHaveScreenshot() has no reference image, Playwright writes one. Treat that file as a reviewed test artifact, not an automatic approval. The visual guide recommends storing snapshot files in version control so changes are visible in code review.
Intentional product changes
After confirming that a visual or semantic change is expected, update snapshots with:
npx playwright test --update-snapshotsThe same workflow updates ARIA snapshot templates and produces reviewable patch files by default. Review the resulting image or text diff against the intended product change before committing it.
Rank #3
- 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.
File format and location
PNG is the default screenshot snapshot format. Playwright also supports lossless WebP when the snapshot filename uses the .webp extension. Snapshot path templates and project configuration can determine where artifacts are stored; the TestProject API documents project-level configuration that affects test output.
Combining both checks without duplicating every test
Use both assertions when the page has two independent contracts. For example, a checkout component may need a stable visual arrangement and an accessible dialog structure:
test('checkout is visual and accessible', async ({ page }) => {
await page.goto('https://example.com/checkout');
const summary = page.locator('[data-testid="order-summary"]');
await expect(summary).toHaveScreenshot('order-summary.png');
const payment = page.getByRole('region', { name: 'Payment' });
await expect(payment).toMatchAriaSnapshot(`
- region "Payment":
- heading "Payment"
- textbox "Card number"
- button "Place order"
`);
});Do not add both by habit. Each assertion creates a separate expected artifact and a separate review decision. If the requirement is only “the submit button is enabled,” a focused assertion is less noisy and more diagnostic.
Troubleshooting common failures
Unexpected screenshot diff
- Cause: Different OS, browser, fonts, hardware or headless settings. Fix: compare in the same pinned environment used to generate the baseline.
- Cause: Animations, rotating content or asynchronous data. Fix: use deterministic fixtures, scope the locator, and let Playwright’s stability wait complete before investigating the diff.
- Cause: An intentional design update. Fix: inspect the diff, then run
npx playwright test --update-snapshotsonly after approval.
Missing baseline
Run the test once in the intended environment to generate the reference, review the artifact, and commit it with the test. Do not generate baselines in an environment that differs from CI unless that difference is intentional and documented.
ARIA snapshot mismatch
- Cause: A role, accessible name, text node or hierarchy changed. Fix: inspect the semantic diff and decide whether the product change is correct.
- Cause: The template covers too much page content. Fix: move the assertion to a locator for the relevant region.
- Cause: The test is checking a single value. Fix: replace the broad snapshot with a focused text, value or role assertion.
Flaky screenshots across machines
First verify environment consistency rather than repeatedly approving changed images. Standardize browser versions, fonts, viewport and execution mode, and remove volatile content from the captured scope. A changed image is a diff to investigate, not proof that the baseline should be replaced.
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
Or skip the browser setup
If you need a rendered image outside a Playwright test, ScreenshotNeo provides a website screenshot API and MCP server. One GET request returns PNG, JPEG, WebP or PDF. It accepts cookie or consent banners before capture and removes more than 60 known consent platforms, newsletter popups and chat widgets; each step can be disabled. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads and cache hits are not billed, and response headers identify the page verdict and billing status.
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 →Use this cURL call (see the complete ScreenshotNeo documentation):
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython:
import requests
r = requests.get("https://api.screenshotneo.com/v1/shot", params={"access_key": "YOUR_API_KEY", "url": "https://stripe.com"}, timeout=90)
open("shot.webp", "wb").write(r.content)Node.js:
const q = new URLSearchParams({ access_key: 'YOUR_API_KEY', url: 'https://stripe.com' });
const res = await fetch(`https://api.screenshotneo.com/v1/shot?${q}`);ScreenshotNeo also supports full-page captures with lazy images loaded, CSS-selector elements, dark mode, 12 device presets and custom viewports, retina scale, PDF paper and page-range controls, custom CSS or JavaScript, pre-capture clicks, hidden selectors, waits for selectors, delays or network idle, request and ad blocking, custom headers, cookies, user agents, authorization, timezone, geolocation, transparent backgrounds, resizing, chosen cache TTLs, signed image links, asynchronous jobs with signed webhooks, bulk capture for up to 100 URLs per call, usage reporting and an OpenAPI specification. An MCP server exposes take_screenshot, get_page_info and capture_pdf to Claude, Cursor and other MCP clients.
The Free plan includes 1,000 screenshots per month with no card. Paid plans start at $5 for 3,000 shots; every feature is available on every plan, and yearly billing gives two months free. Create a free ScreenshotNeo account.
FAQ
Does an ARIA snapshot test visual accessibility?
No. It tests the accessibility tree’s roles, names, text and structure. Use a screenshot or other visual and accessibility-specific checks for appearance-related requirements.
Are screenshot snapshots suitable for every regression test?
No. They are appropriate when rendered appearance is the contract. For a single value or behavior, a focused assertion is usually clearer and less expensive to maintain.
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.
Can I use a locator instead of the whole page?
Yes. Both visual screenshot assertions and ARIA snapshot assertions can be scoped to a locator, which helps isolate the contract and reduce unrelated changes.
Frequently Asked Questions
Does an ARIA snapshot test visual accessibility?
No. It tests the accessibility tree’s roles, names, text and structure. Use a screenshot or other visual and accessibility-specific checks for appearance-related requirements.
Are screenshot snapshots suitable for every regression test?
No. They are appropriate when rendered appearance is the contract. For a single value or behavior, a focused assertion is usually clearer and less expensive to maintain.
Recommended Free Tools
Can I use a locator instead of the whole page?
Yes. Both visual screenshot assertions and ARIA snapshot assertions can be scoped to a locator, which helps isolate the contract and reduce unrelated changes.
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.
