Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
World desk3 min

Why Are My Playwright Screenshots Blurry on High-DPI Screens?

Playwright’s screenshot scale and deviceScaleFactor determine whether output uses CSS or device pixels. Set them explicitly and check visual-test defaults.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Most often, the screenshot’s pixel scale does not match the output you expect. Playwright can save one pixel per CSS pixel or one per device pixel; check the screenshot’s scale and the browser context’s deviceScaleFactor before changing anything else.

How screenshot scale affects sharpness and dimensions

CSS pixels describe the page layout; device pixels describe the physical-pixel scale being emulated. With scale: 'css', Playwright produces one output pixel per CSS pixel. With scale: 'device', it produces one output pixel per device pixel, so a high-DPI capture can have more pixels than the CSS viewport dimensions.

As an Amazon Associate I earn from qualifying purchases.

The page screenshot API documents device as the default. For predictable output, choose the scale explicitly:

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.
await page.screenshot({ path: 'capture.png', scale: 'device' });

Choose device when you want the output to represent device pixels. Choose css when you want dimensions in CSS pixels. See the Playwright page screenshot options.

#1 Best Overall
Sale
Dell 27 Monitor S2725QS, 4K UHD IPS, 120Hz, 5ms, FreeSync Premium | 350 cd/m2 Brightness, 1,500:1 Contrast, 99% sRGB, Anti-Glare, HDMI, DisplayPort, USB‑C, Height Adjustable, Swivel, Pivot
  • Improved ComfortView Plus: Reduces harmful blue light emissions to ≤35%, for all-day comfort without sacrificing color accuracy.
  • Refresh rate: A smooth, tear-free experience with AMD FreeSync Premium (refresh rate up to 120Hz) and an ultra-low 0.03ms response time create a captivating experience for work and play.
  • Vivid colors: Immerse yourself in breathtaking 4K visuals with in-plane switching technology. Enjoy vibrant colors with 99% sRGB. The 1500:1 contrast ratio and HDR readiness deliver excellent depth and detail.
  • Re-engineered sound quality: Enjoy more detailed sound with spacious audio featuring greater output power, deeper frequency response and more decibel range than the previous generation.
  • Ultra-thin bezel: Designed with a sleek, modern aesthetic and an ash white finish, this display features ultra-thin bezels for a refined, minimalist design.

Check the context’s device scale factor

deviceScaleFactor is separate from viewport width and height. It defaults to 1; Playwright’s high-DPI emulation example uses 2. Set both values to match the scenario you intend to reproduce:

const context = await browser.newContext({
  viewport: { width: 2560, height: 1440 },
  deviceScaleFactor: 2,
});

Then capture with the explicit scale that matches your goal. For example, with the context above, scale: 'device' produces output at device-pixel scale, while scale: 'css' keeps output dimensions at CSS-pixel scale. The Playwright emulation guide covers viewport and device emulation.

Rank #2
Sale
LG 27US500-W Ultrafine Monitor 27-Inch 4K UHD (3840x2160) HDR10 IPS Borderless Design Reader Mode Flicker Safe Switch App HDMI DisplayPort - White
  • 4K UHD with 1000:1 Contrast Ratio - This UltraFine display with a 1000:1 contrast ratio displays deeper blacks and vivid colors in UHD clarity. With wide viewing angles, it gives creative professionals the ability to view and work with highly-detailed, digital imagery.
  • 4K HDR10 DCI-P3 - Explore HDR10 content the way it was meant to be seen with up to 90% DCI-P3 color gamut expression—an elevated color spectrum that brings brilliant color to life.
  • Onscreen Control - You can customize the workspace by splitting the display or adjusting basic monitor options with just a few mouse clicks.
  • Ergonomic Stand - The ergonomic stand makes it easy to flexibly adjust the tilt of the screen in the optimal position for you.
  • What's In The Box - Stand Body, Stand Base, Screws, Power Adapter, HDMI Cable, Quick Start Guide, Registration Card, Warranty.

If the problem is in a visual regression test

Screenshot assertions are a separate API from page.screenshot(). Their documented default scale is css, unlike the page screenshot API’s documented device default. If you compare an assertion against an image captured with device scale, explicitly align the scale settings rather than assuming the defaults match. See screenshot assertions.

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

Diagnose a blurry or mismatched capture

  1. Compare dimensions. Check the image’s pixel dimensions against the CSS viewport. A device-scale capture can be larger than the viewport when the context uses a high device scale factor.
  2. Set screenshot scale explicitly. Use device for device-pixel output or css for CSS-pixel output.
  3. Verify emulation. Check the context’s deviceScaleFactor and viewport independently; make sure each matches the display scenario you are reproducing.
  4. For visual tests, inspect assertion settings separately. The assertion API’s default is CSS scale, so align it with the image and comparison you intend to use.
  5. If scale and dimensions are right, check rendering consistency. Playwright notes that rendering can vary with the host operating system, browser version and settings, hardware, power source, and headless mode. Run baseline and current captures in as consistent an environment as practical. See the visual comparisons guide.

A larger pixel count does not by itself establish that an image will look sharper after it is resized or displayed elsewhere. Check the actual output at the size and in the context where you plan to use it.

Rank #3
Sale
Dell 32 Monitor S3225QS, 4K UHD VA, 120Hz, FreeSync Premium, Eye Comfort | 3840x2160, 31.5in, 3000:1 Contrast, 300 cd/m2 Brightness, 4ms, 99% sRGB, Anti-Glare, HDMI, DisplayPort
  • Improved ComfortView Plus: Reduces harmful blue light emissions to ≤35%, for all-day comfort without sacrificing color accuracy.
  • Refresh rate: A smooth, tear-free experience with AMD FreeSync Premium (refresh rate up to 120Hz) and an ultra-low 0.03ms response time create a captivating experience for work and play.
  • Vivid colors: Immerse yourself in 4K visuals with a VA panel. Enjoy true-to-life colors with 99% sRGB and 95% DCI-P3 coverage. The 1500:1 contrast ratio and HDR readiness deliver excellent depth and detail.
  • Re-engineered sound quality: Enjoy more detailed sound with spacious audio featuring greater output power, deeper frequency response and more decibel range than the previous generation.
  • Ultra-thin bezel: Designed with a sleek, modern aesthetic and an ash white finish, this display features ultra-thin bezels for a refined, minimalist design.

Or skip the browser setup

If you need a screenshot without configuring Playwright, ScreenshotNeo returns an image or PDF from one GET request. For example, this cURL call saves a WebP capture:

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

See the ScreenshotNeo API documentation for options and setup. Cookie banners are accepted and removed, along with known consent platforms, newsletter popups, and chat widgets, before the capture; those steps can be turned off. Bot checks, blank pages, timeouts, failed loads, and cache hits are not billed, and response headers report the page verdict and billing status. ScreenshotNeo also provides an MCP server with screenshot tools for AI agents. The free plan includes 1,000 screenshots per month with no card; paid plans start at $5 for 3,000.

Sign up for ScreenshotNeo’s free plan.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Frequently Asked Questions

Should I use scale: 'css' or scale: 'device'?

Use css for one output pixel per CSS pixel and device for one output pixel per device pixel.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
Samsung 27" Odyssey G5 (G51F) Series QHD (1440P) Gaming Monitor | 180Hz, 1ms, AMD FreeSync, HDR10, Height Adj Stand, Black Equalizer, Virtual Aim Point, Auto Source Switch+ (LS27FG512ENXZA)
  • QHD Resolution (2560 x 1440) has 1.7 times the pixel density of Full HD for incredibly detailed pinsharp images
  • HDR10 provides brighter highlights and nuanced shadow for added depth - making every scene feel more vivid and realistic
  • The 180Hz refresh rate minimizes lag for gameplay with ultra-smooth action. Plus, the 1ms response time helps capture your moves in real-time, allowing you to react fast for gaming precision
  • AMD FreeSync reduces choppiness, screen lag and image tearing, ensuring that your fast-paced, complex in-game action is stable with minimal stutter
  • Ergonomic stand allows for tilt, pivot and height adjustments to maximize gaming comfort

Does a high-DPI screenshot require a high-DPI monitor?

The documented remedy is to configure Playwright’s screenshot scale and emulated device scale factor; a physical display upgrade is not required for those settings.

Best Value
Dell 27 Monitor S2725QC, 4K UHD IPS, 120Hz, 99% sRGB, 4ms, FreeSync Premium
  • Low blue light: The improved ComfortView Plus reduces harmful blue light emissions to ≤35%, for all-day comfort without sacrificing color accuracy.
  • Refresh rate: A smooth, tear-free experience with AMD FreeSync Premium (refresh rate up to 120Hz) and an ultra-low 0.03ms response time create a captivating experience for work and play.
  • Vivid colors: Immerse yourself in breathtaking 4K visuals with in-plane switching technology. Enjoy vibrant colors with 99% sRGB. The 1500:1 contrast ratio and HDR readiness deliver excellent depth and detail.
  • Re-engineered sound quality: Enjoy more detailed sound with spacious audio featuring greater output power, deeper frequency response and more decibel range than the previous generation.
  • Easy connectivity: Keep your desk organized and clutter-free with a single USB-C cable (up to 65W power delivery).

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.

Leave a Reply

Your email address will not be published. Required fields are marked *

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.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.