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
Redmond desk5 min

Puppeteer Screenshot in Node.js on Windows: Fix Chrome Launch Errors

Diagnose Puppeteer launch errors on Windows by checking the browser download, Chrome policies, sandbox permissions, and executable configuration before taking a screenshot.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

If Puppeteer fails before it can capture a screenshot on Windows, first identify whether Chrome is missing, blocked by an extension policy, or denied access by the Windows sandbox. Those errors need different fixes; adding --no-sandbox by default can hide the diagnosis rather than solve it. This guide follows the error from installation through launch to a working screenshot.

1. Check that Puppeteer’s browser actually installed

The puppeteer package normally downloads a compatible Chrome for Testing build and, since Puppeteer v21.6.0, a separate chrome-headless-shell binary. If your package manager blocks dependency install scripts, the browser download may have been skipped. One common symptom is Could not find Chrome (ver. ...).

  1. From your project directory, run npx puppeteer browsers install to install the browser manually.
  2. If your package manager requires explicit permission for dependency scripts, allow Puppeteer’s install script according to that package manager’s policy.
  3. Check that the browser cache is available to the same Windows user account that runs Node.js. Puppeteer’s documented default cache moved to ~/.cache/puppeteer in v19.0.0.

Puppeteer documentation version 25.12.0 gives an approximate Windows Chrome for Testing download size of 280 MB; the actual download or installed size can vary. See the Puppeteer installation guide.

2. Match the launch error to its Windows fix

Chrome policy requires extensions

Puppeteer passes --disable-extensions by default. On some managed Windows systems, Chrome policy enforces extensions, and that conflict can prevent Chrome from launching. If the error coincides with an extension policy, try Puppeteer’s documented enableExtensions launch option:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
const browser = await puppeteer.launch({
  enableExtensions: true,
});

This is a targeted policy workaround, not a general launch flag to add to every project. See Puppeteer’s Windows troubleshooting guide.

Sandbox reports “Access is denied”

A Windows sandbox permissions failure can look like this: Sandbox cannot access executable. Check filesystem permissions are valid ... Access is denied. (0x5). Puppeteer v22.14.0 and later attempts to configure permissions for its downloaded Chrome by running Chrome’s setup.exe during browser installation. If you use an older Puppeteer version, or the error persists after installation, the troubleshooting guide documents this manual permission grant:

icacls "%USERPROFILE%/.cache/puppeteer/chrome" /grant *S-1-15-2-1:(OI)(CI)(RX)

Run it in Command Prompt or PowerShell. The documented path assumes Puppeteer’s default cache location; if your browser cache is configured elsewhere, adjust the target to the actual downloaded Chrome directory. The guide notes that a more restrictive SID may be preferable in high-security environments. Do not treat disabling Chrome’s sandbox as the standard Windows permission fix.

Rank #2
Dell Latitude 3190 11.6" HD 2-in-1 Touchscreen Laptop Intel N5030 1.1Ghz 4GB Ram 128GB SSD Windows 11 Professional (Renewed)
  • 1.1 GHz (boost up to 2.4GHz) Intel Celeron N5030 Quad-Core
  • 4GB DDR4 System Memory; 128GB Solid State Drive
  • 11.6" HD (1366 x 768) Multi-Touch Display
  • Combo headphone/microphone jack - Noble Wedge Lock slot - HDMI; 2 USB 3.1 Gen 1
  • Windows 11 Pro

3. Verify Node, Windows, and browser selection

Puppeteer documentation version 25.12.0 lists Node 22.12 or newer and Chrome for Testing on Windows x64 as system requirements. It also lists tar.exe or PowerShell as the Windows unpacking utility, unless the optional yauzl dependency is installed. These requirements are specific to that documentation version and may change; check the current system requirements before upgrading or diagnosing an installation issue.

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

Choose the package and browser ownership model deliberately:

Setup What it does What to check
puppeteer Downloads and manages a compatible browser. Confirm install scripts ran and the downloaded browser is present.
puppeteer-core Does not download Chrome; intended for a remote browser or a browser you manage. Supply a valid executablePath or supported channel.

When you manage Chrome yourself, for example, select a regular Chrome installation by channel or point directly to the executable:

Rank #3
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
  • 256 GB SSD of storage.
  • Multitasking is easy with 16GB of RAM
  • Equipped with a blazing fast Core i5 2.00 GHz processor.
const browser = await puppeteer.launch({
  channel: 'chrome',
  // Or use executablePath: 'C:\Program Files\Google\Chrome\Application\chrome.exe'
});

Use either channel or executablePath according to how Chrome is installed; the example path is a common location, not guaranteed for every Windows installation. Puppeteer guarantees operation only with its bundled browser, so a separately managed Chrome version introduces compatibility risk. See the installation guide and LaunchOptions reference.

4. Turn on browser output and test visible Chrome

When the error is unclear, capture Chrome’s own output before trying extra flags. dumpio: true pipes browser stdout and stderr to Node’s output. The documented default startup timeout is 30 seconds, so startup output can also distinguish a slow launch from a missing executable or permissions problem.

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.
const browser = await puppeteer.launch({
  dumpio: true,
  headless: false, // temporary diagnosis; remove if not needed
});

Current Puppeteer defaults to regular headless Chrome. The separate headless: 'shell' mode runs chrome-headless-shell, which does not completely match regular Chrome behavior. If a page or screenshot relies on a feature that behaves differently in the shell, compare regular headless Chrome with visible Chrome using headless: false. See the headless modes guide and LaunchOptions reference.

Rank #4
15.6 Inch Laptop Computer, N4020, 4GB DDR4 RAM, 128GB eMMC,with Windows 11
  • EFFORTLESS EVERYDAY PERFORMANCE: Powered by Intel Celeron N4020 processor and Windows 11 Home system, delivering reliable, low-power efficiency for daily tasks like document editing, email, online classes, and web browsing
  • 15.6-INCH FULL HD DISPLAY: Enjoy immersive visuals on the 15.6" FHD (1920x1080) anti-glare screen with micro-edge bezels. Delivers clear details and comfortable viewing for long study sessions, working on spreadsheets, and video playback
  • RESPONSIVE MULTITASKING & STORAGE: Built with 4GB LPDDR4 RAM and 128GB eMMC storage for smooth daily essential use. Expand your storage by up to 1TB via the integrated TF card slot to easily store movies, photos, and working files
  • ADVANCED CONNECTIVITY: Outfitted with 2x Full-Featured Type-C ports for data transfer, fast charging, and dual-monitor output, alongside 2x USB 3.2 Gen1 ports and a 3.5mm audio jack for complete peripheral compatibility
  • LIGHTWEIGHT & SILENT OPERATION: Slim and portable for effortless travel or commuting. Features a 1MP HD webcam for remote meetings, 38Wh battery with 45W Type-C fast charging, and a fanless silent design for peaceful work environments.

5. Capture the screenshot once launch succeeds

This complete CommonJS example launches the bundled browser, navigates to a page, saves a screenshot, and closes Chrome even if navigation or capture throws an error:

const puppeteer = require('puppeteer');

(async () => {
  const browser = await puppeteer.launch();
  try {
    const page = await browser.newPage();
    await page.goto('https://example.com', { waitUntil: 'networkidle2' });
    await page.screenshot({ path: 'screenshot.png' });
  } finally {
    await browser.close();
  }
})();

page.screenshot() captures a page; for a specific element, use ElementHandle.screenshot(). The Puppeteer screenshots guide documents both approaches.

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

Or skip the browser setup

If your task is simply to retrieve a website screenshot and you do not need to run Chrome locally, ScreenshotNeo provides a website screenshot API and MCP server. One GET request takes a URL and returns PNG, JPEG, WebP, or PDF. Its browser setup is handled for you; cookie banners, newsletter popups, and chat widgets are removed before capture, and bot checks, blank pages, and failed loads are never billed. Its MCP server lets AI agents take screenshots, and the free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000 shots.

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.

Install no browser for this request; use the ScreenshotNeo API documentation for options and authentication details. Replace the example URL with the site you need to capture:

Best Value
15.6 Inch Win 11 Laptop Computer, N4020, 4GB DDR4 RAM, 128GB Storage
  • WINDOWS 11 | STABLE PERFORMANCE: Powered by Intel Celeron N4020 processor and Windows 11 system, this laptop delivers stable performance for everyday computing tasks. It supports web browsing, online learning, document editing, email communication, and basic office work with optimized power efficiency, providing a practical and reliable experience for essential daily use for daily use.
  • 15.6” FHD IPS DISPLAY: Features a 15.6-inch Full HD IPS display with narrow bezels, offering wider viewing angles and clearer image details compared to standard panels. The improved screen-to-body ratio enhances visual experience for study, reading, document work, and video playback, making it suitable for both productivity and entertainment use.
  • 4GB DDR4 + 128GB eMMC STORAGE: Equipped with 4GB DDR4 memory and 128GB eMMC storage for everyday basics such as browsing, documents, email, and online learning platforms. The built-in TF card slot supports storage expansion up to 1TB, giving you more flexibility for files, photos, videos, and daily documents. TF card not included.
  • CONNECTIVITY & PORTS: Includes 1× TF card slot, 2× USB 3.2 Gen1 ports, and 2× full-featured Type-C ports (USB 3.2 Gen1). The Type-C ports support data transfer, charging, and video output, enabling flexible connection with external devices such as monitors, storage, and peripherals for daily work and study use.
  • LIGHTWEIGHT DESIGN | ONLINE COMMUNICATION: Designed with a slim, portable profile, this laptop is easy to carry for school, commuting, and travel. A built-in 1MP front camera supports online classes, video meetings, remote communication, and everyday conferencing. The 3300mAh battery works with the low-power system design to support practical daily use, while thermal optimization helps maintain quieter operation during extended tasks.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webp

Sign up for ScreenshotNeo’s free plan to get 1,000 screenshots a month with no card.

Troubleshooting checklist

  • Could not find Chrome: Run npx puppeteer browsers install; check whether the package manager skipped Puppeteer’s install script and whether Node is using the expected cache.
  • Chrome exits immediately on a managed machine: If the environment enforces extensions, try enableExtensions: true rather than adding unrelated flags.
  • Sandbox cannot access executable or access denied: Check Puppeteer’s version and downloaded Chrome permissions; for older versions or a persistent failure, use the documented icacls command after verifying the cache path.
  • Using puppeteer-core: It does not install a browser. Confirm the executablePath exists or that the selected channel is installed.
  • Launch waits and times out: Set dumpio: true and inspect Chrome output before changing timeout or launch flags.
  • Screenshot differs in shell mode: Compare with regular headless Chrome or visible mode; the shell does not fully match regular Chrome.

For more diagnosis tied to Windows policies and permissions, use Puppeteer’s troubleshooting guide.

Quick Recap

Bestseller No. 1
HP 14' HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
HP 14" HD Laptop, Windows 11, Intel Celeron Dual-Core Processor Up to 2.60GHz, 4GB RAM, 64GB SSD, Webcam, Dale Pink (Renewed)
14" diagonal, 1366x768 resolution, HD BrightView LED, Glossy NON-TOUCH Display
$245.99
Bestseller No. 2
Dell Latitude 3190 11.6' HD 2-in-1 Touchscreen Laptop Intel N5030 1.1Ghz 4GB Ram 128GB SSD Windows 11 Professional (Renewed)
Dell Latitude 3190 11.6" HD 2-in-1 Touchscreen Laptop Intel N5030 1.1Ghz 4GB Ram 128GB SSD Windows 11 Professional (Renewed)
1.1 GHz (boost up to 2.4GHz) Intel Celeron N5030 Quad-Core; 4GB DDR4 System Memory; 128GB Solid State Drive
Bestseller No. 3
Dell Latitude 5420 14' FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
Dell Latitude 5420 14" FHD Business Laptop Computer, Intel Quad-Core i5-1145G7, 16GB DDR4 RAM, 256GB SSD, Camera, HDMI, Windows 11 Pro (Renewed)
256 GB SSD of storage.; Multitasking is easy with 16GB of RAM; Equipped with a blazing fast Core i5 2.00 GHz processor.
$285.00

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.

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

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
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

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.