October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PCOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk5 min

How to Fix a Website Screenshot That Is Too Dark in Headless Chrome

A dark headless Chrome screenshot may reflect the page’s color-scheme preference. Set Playwright to light, verify the media query, and control capture conditions.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If a website screenshot is too dark, first check whether the page is rendering its dark theme because of prefers-color-scheme. In Playwright, explicitly set the browser context or page to light, verify the media-query result, and then capture. If the theme is already light, investigate page readiness and keep the browser and host environment consistent. Puppeteer’s omitBackground option controls transparency; it does not switch a site to light mode.

1. Check which color scheme the page sees

A page can respond to the browser’s prefers-color-scheme preference with different colors, including a dark theme. Headless Chrome does not, by itself, guarantee that a site renders in light mode. Check the media queries in the same page you plan to capture:

As an Amazon Associate I earn from qualifying purchases.

const colorState = await page.evaluate(() => ({
  dark: matchMedia('(prefers-color-scheme: dark)').matches,
  light: matchMedia('(prefers-color-scheme: light)').matches,
}));
console.log(colorState);

If dark is true, the page is receiving a dark preference. Playwright documents that page.emulateMedia({ colorScheme: 'dark' }) makes the dark query true and the light query false; setting light requests the opposite. See the Playwright Page API.

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.

2. Set light mode before capturing

Use one of Playwright’s two documented controls. Choose based on whether the preference should apply to the whole browser context or be changed for a particular page.

#1 Best Overall
Quntis Computer Monitor Lamp, Screen Monitor Light Bar for Eye Caring, USB Reading LED Task Lamp with Auto-Dimming, Dimmable Light Bar, Touch Control, No Glare Space Saving Home Office Desk Lamps
  • No Blue Light Hazard & Flicker-Free Lighting: Certified to meet the IEC/TR 62778 and IEC/EN 62471 standards, Quntis monitor light bar effectively eliminates harmful blue light that may affect vision, reducing eye irritation and providing optimal eye protection. Enjoy our flicker-free illumination that provides a stable light source without worrying about eye discomfort. Experience a truly comfortable and eye-friendly illumination with Quntis computer monitor light.
  • No Screen Glare & Space Saving: The innovative asymmetrical optical design only illuminates your desk area, enhancing immersion and focus while ensuring no reflected glare on your screen. Our scientifically designed weighted clip easily mounts on top of the monitor, saving valuable desk space.
  • Auto-Dimming & Stepless Dimming: The built-in ambient light sensor continuously monitors the surrounding brightness and intelligently adjusts the existing light to 900 lux, preventing visual fatigue by avoiding excessive or insufficient lighting. The ScreenLinear monitor lamp also allows manual adjustments for both brightness and color temperature (3000K-6500K), so you can customize the lighting to your preference for optimal comfort.
  • Close to Natural Light & Ultra-High Ra98 Color Rendering Index: Our computer light bar features 78 high-quality LED beads, offering uniform and adequate lighting while minimizing shadows and glare, creating a comfortable lighting environment for reading, working, and gaming. High CRI enhances vibrant and true-to-life colors, making objects on your screen appear vivid and realistic. Perfect for professionals engaged in color work, ensuring color accuracy and minimizing eye fatigue.
  • Masterful Illumination, Empowering Eye Care: Quntis monitor reading lamp surpasses normal desk lamps by providing exceptional, eye-friendly illumination. It helps develop healthier visual habits during screen time and reduces the risk of myopia. Ideal for students, designers, and office workers, the ScreenLinear is a great solution for a comfortable visual experience, whether you’re reading, gaming, or spending long hours in front of a screen.

Set the scheme for a browser context

Set colorScheme: 'light' when pages in the context should share the same preference. Playwright’s documented default context color scheme is light, but explicitly setting it makes the intended test setup clear.

const context = await browser.newContext({ colorScheme: 'light' });
const page = await context.newPage();
await page.goto(url);

const colorState = await page.evaluate(() => ({
  dark: matchMedia('(prefers-color-scheme: dark)').matches,
  light: matchMedia('(prefers-color-scheme: light)').matches,
}));
console.log(colorState);

await page.screenshot({ path: 'page.png' });

Set the scheme at page level

Use page.emulateMedia() when a test needs to change schemes on a page, for example to capture both light and dark appearances. Apply it before taking the screenshot, then verify the media-query result as above.

Rank #2
Samphon Monitor Light Bar, Eye-Care USB Reading Mnitor lamp, 11.8'' LED Computer Lights with Ultrawide Lighting, 3 Color Temperature Dimmable Desk Light for Home Office Gaming
  • Bright, Wide, and Even Illumination Monitor Light : 11.8-inch screen light bar delivers up to 800 lux of central brightness for 30''*20'' coverage area, offering significantly brighter and more uniform lighting than conventional desk lamps. It eliminates dark spots and minimizes eye strain during extended work or gaming sessions, ensuring a comfortable and well-lit workspace.
  • Eye-Friendly Desk Lamp: Dimmable 45° lighting illuminates just your screen and desk, not your eyes. This screen bar eliminates reflections and minimizes factors that cause digital eye strain, creating an optimized and comfortable lighting environment right at your desktop, ideal for long hours of computer use.
  • Stepless Dimming with Memory Function : 3 color temperatures (3000-4000-6500K) and brightness levels seamlessly via ON/OFF switch to match your needs for work , reading , games or relaxation. Computer light also with built-in memory function automatically recalls your last settings for convenience.
  • USB Power and Easy Operation Reading Light: Powered via USB from computers, adapters, or mobile power banks, this light offers broad compatibility. Mechanical ON/OFF switch on right side of the monitor lamp for all functions control,short press for ON/OFF and color temperature changing, long press for brightness adjusting. Control your desktop light at your fingertips.
  • Space-Saving, Secure Mounting Design:With its patented counterweight clip, the bar light installs instantly without tools and fits for most of the screens from thin to thick, from regular to curved. It stays firmly in place without occupying desk space, making it perfect for clutter-free setups.
await page.emulateMedia({ colorScheme: 'light' });
// Verify matchMedia('(prefers-color-scheme: light)').matches before capture.
await page.screenshot({ path: 'page.png' });

To reset color-scheme emulation, pass null. The Page API marks no-preference as deprecated; use light or dark when you need a specific appearance. For the exact API behavior, consult the Page API and BrowserType API.

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

3. Separate theme problems from transparency

In Puppeteer, omitBackground hides the default background so the captured result can be transparent. It defaults to false and does not apply to JPEG. It is not a control for a website’s light or dark theme. If the page itself looks dark, set or verify the color-scheme preference instead. See the Puppeteer ScreenshotOptions reference.

Rank #3
Sale
16.14" Monitor Light Bar,250LM USB LED Desk Lamp,Home Office Gaming
  • 【No Screen Glare & Flicker-Free】Glare will tire your eyes and cause headache. Different from traditional lamp, Colorpanda computer monitor light adopts asymmetric optical and Anti-Blue Light design, which can effectively avoid screen glare. Monitor lamp can reduce the fatigue caused by working or studying with the computer for a long time.
  • 【Dimming & Memory Function】Boasting a premium metallic finish, this monitor light features 3 color temperatures & brightness levels (2700-4000-6500K), adjustable via touch buttons to meet your demands for work, reading and rest. The built-in memory function saves your last setting automatically.
  • 【Space Saving Design】Innovative counterweight design makes it easy and stable to fix the monitor light bar on the top of your computer. Unlike traditional task lamp, it does not take up space on your desk. Small size for easy storage and portability.
  • 【Easy to Install & Wide Range of Use】The patented clip-on design enables it to be installed in seconds! Without any tools, just clip the desk lamp on screen. Flexible design, suitable for screen thicknesses from 0.12” to 2.2” (0.3cm TO 5cm). It's convenient to use.
  • 【Colorpanda Benefits】It’s long lifespan also reduces maintenance costs.Colorpanda high quality lighting increases productivity.Our customer support team will also address your concerns within 12 hours.

4. Stabilize the page and capture environment

Wait for the page state you need

Capture only after navigation and any page-specific content you care about have loaded. Puppeteer’s screenshot guide shows page.goto(url, { waitUntil: 'networkidle2' }) before page.screenshot() as one example. That wait condition is a useful starting point, not a guarantee that every site is visually settled: applications may render later, continue background requests, or load content after scrolling. Add an explicit wait for a relevant selector or known page state when needed. The guide does not establish a universal delay that works for every site.

See the Puppeteer Screenshots guide for its navigation-and-capture example.

Rank #4
Sale
YEELIGHT Monitor Light Bar, Computer Monitor Lamp for Home Office Gaming, 250LM No Glare Eye-Care LED Screen Bar, Touch Control USB Reading Desk Lamp with Stepless Dimming for Flat & Curved Monitor
  • 【Discover Ultimate Eye Care with YEELIGHT Monitor Light Bar】Protect your vision and elevate your workspace with the YEELIGHT ScreenBar. Our cutting-edge technology not only effectively filters out harmful blue light but also boasts an RG0 rating—the highest standard for blue light safety. This safeguards your eyes from potential damage and ensures long-lasting comfort during extended computer use. Bid farewell to screen glare and enjoy a clear, unobstructed view thanks to our innovative design that minimizes reflections on your screen. Furthermore, our flicker-free illumination provides a stable, stress-free light source, ideal for both work and leisure
  • 【Effortless Stepless Dimming & Personalized Color Temp Settings】Revolutionize your lighting experience with the YEELIGHT Monitor Light Bar. This lamp offers seamless stepless dimming and color temperature adjustment ranging from 2700K to 6500K for personalized illumination. Effortlessly fine-tune brightness and color through intuitive long-press controls to create ideal lighting for gaming, working, or studying. For added convenience, three fixed color temperature modes can be activated with a single touch, letting you quickly adapt to focused working, reading, or relaxed viewing scenes
  • 【Ultra-High CRI Ra95 for True Color Fidelity】Illuminate your workspace with stunning color accuracy and ultimate eye care. YEELIGHT's ScreenBar features an ultra-high Color Rendering Index of Ra95, paired with 78 high-quality LED beads, providing even, ample illumination. It minimizes shadows and glare, creating a comfortable, natural lighting environment ideal for reading, working, and gaming. The screen lamp ensures vibrant, true-to-life colors, perfect for color-related professionals. Maintain screen color calibration and reduce eye fatigue with this monitor light bar, enhancing productivity and comfort
  • 【Effortless Install, Space-Saving Brilliance】YEELIGHT's Monitor lamp offers a cutting-edge lighting solution with easy installation and space-saving design. Its retractable clip adapts to monitors from 0.3" to 1.1" thick, compatible with flat and curved monitor screens. Set up in seconds and save over 50% desk space vs. traditional lamps. Powered by USB with a 1.5m cable, it eliminates lamp bases and tangled wires. Enjoy an organized workspace with precision and elegance, enhancing your viewing experience
  • 【Premium Full-Metal Monitor Light Bar with Camera-Friendly Design】The YEELIGHT Monitor Light Bar features a premium full-metal body, offering durability and a sleek design for modern workspaces. Its metallic finish ensures effective heat conduction, keeping it cool during prolonged use and reducing burn risks. The robust construction enhances longevity, outperforming plastic alternatives. The low-profile design avoids webcam obstruction, enabling seamless video calls and multitasking. Combining durability, functionality, and thoughtful design, it’s an ideal workspace addition

Keep visual comparisons in the same environment

Playwright notes that rendering can vary with the host operating system, browser version, settings, hardware, power source, and whether the browser is headed or headless. For visual comparisons, run the baseline and new capture in the same environment rather than assuming every difference is a page-theme issue. See Playwright Visual comparisons.

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

Match viewport and device scale

Use consistent context options when comparing images, especially viewport and deviceScaleFactor. Playwright documents a default device scale factor of 1. This setting affects output sampling and dimensions; the documentation does not identify it as a way to brighten a page or change its color scheme. See the BrowserType API.

Best Value
SAMPHON RGB Monitor Light Bar, Eye-Care Dual Light Reading Screen Lamp, 9 Modes Gaming Backlight LED Computer Lamp, 3 Colors Dimmable Frontlight, 15.75'' USB Desk Lights for Home, Office
  • Dual-Mode Monitor Light Bar, for Focus and Atmosphere: SAMPHON RGB computer lights combine two lighting modes. Front light eliminates screen glare and evenly lights your desk, protecting your eyes during work or study. Simultaneously, the 9-mode RGB backlight casts vibrant colors behind your screen, creating the perfect ambient atmosphere for gaming, movies, or relaxation. Get both essential task lighting and dynamic mood lighting without cluttering your desk
  • Eye Comfort Monitor Lamp: Screen bar with a 45° beam angle to light only your desk and screen, No direct light to your eyes. Targeted lighting drastically reduces eye strain and fatigue, making long sessions at the computer far more comfortable. Just rotate the gaming light bar to suitable angle, switch from a warm, relaxing glow to a cool, focused beam for work with balanced uniform illumination
  • RGB Screen Lamp with 3 Modes: Take full command of your lighting with versatile control. Choose from 9 stunning RGB backlight effects to energize your gaming setup, or select from 3 front light color temperatures for work and reading. Both lights operate independently via intuitive buttons. The smart memory function automatically recalls your last used settings, delivering your personalized lighting instantly every time you turn it on
  • Space-Saving Monitor Lamp: Achieve a clean, organized desk in seconds. This monitor lamp features a universal, retractable clip with a soft silicone pad that grips securely without damaging screens—compatible with thin, thick, flat, and curved monitors. Sleek bar light installs instantly and stays firmly in place, providing a reliable and clutter-free lighting solution for any home or office
  • USB-C Powered LED Desk Lamp with Intuitive Dual Control: Enjoy ultimate plug-and-play convenience. Powered by a universal USB-C cable (works with laptops, adapters, or power banks), this lamp offers flexible placement. Dual tactile buttons provide effortless fingertip control: the left button manages the RGB backlight (modes/on/off), while the right button handles the front light (on/off, color temperature, brightness). Effortlessly create the perfect light for any moment
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

5. Troubleshoot by symptom

Symptom Likely cause What to check or change
The page is consistently dark, and the dark media query is true. The page is responding to a dark color-scheme preference. Set colorScheme: 'light' in the context or call page.emulateMedia({ colorScheme: 'light' }) before capture. Verify that the light query is true.
The media queries show light mode, but the screenshot still looks dark. The page may use its own theme control, or the capture may differ for reasons other than prefers-color-scheme. Inspect the site’s own theme state and compare browser version, OS, settings, and headless/headed mode with the baseline environment.
The image has transparency or an unexpected background. omitBackground affects the screenshot background, not the site theme. Check the Puppeteer screenshot options and output format. Do not use omitBackground to select light mode.
The screenshot is dark only sometimes or differs between runs. Page content may not be settled, or rendering conditions may differ. Wait for the content you need, then compare captures under consistent environment, viewport, and device scale settings.
The screenshot dimensions or sharpness differ. The viewport or device scale factor may not match. Set the same viewport and deviceScaleFactor in both runs; this aligns sampling, not page brightness.

Or skip the browser setup

ScreenshotNeo is a website screenshot API and MCP server. It accepts cookie and consent banners and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each step can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed, and responses identify the page verdict and billing status. Its MCP server gives AI agents tools for screenshots, page information, and PDF capture.

For a one-call capture, use the API’s documentation for options such as output format and rendering settings. This cURL example captures Stripe as WebP:

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

The free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 screenshots. Sign up free for ScreenshotNeo.

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

Sources for the APIs discussed

Frequently Asked Questions

Does setting prefers-color-scheme to light recolor photos on the page?

No. It selects the page’s light-scheme media-query preference; it is not a general image-brightness or photo-recoloring control.

Does deviceScaleFactor affect whether a page uses its dark theme?

No documented behavior in the cited Playwright API makes device scale a theme selector. Use colorScheme or emulateMedia for that.

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 *

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.