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

Some links on this page are affiliate links: if you buy through them we may earn a commission, at no extra cost to you.

To diagnose Puppeteer-Sharp failures, first identify which layer produced the signal: navigation, page JavaScript, the page process, or a network request. Catch navigation exceptions from GoToAsync, subscribe to PageError for uncaught JavaScript exceptions, use Error for a crashed page, and inspect both RequestFailed and response status codes for network problems. A 404 is an HTTP response, not a failed request.

Start by identifying the failure layer

Browser automation can surface several different kinds of problems during one visit. A navigation may time out while the page also logs a warning; an image request may fail while the main document loads; or JavaScript may throw after navigation succeeds. Treating every signal as the same kind of “page error” makes logs noisy and can lead to the wrong recovery action.

Signal What it means What to record or inspect
GoToAsync throws The navigation operation encountered a problem, such as a timeout, SSL error, invalid URL, or unreachable or nonresponsive server. Exception details and the target URL; separately inspect whether a main-resource response was returned.
PageError An uncaught exception happened within page JavaScript. Message and raw Error; the raw value is not guaranteed to be a conventional .NET exception.
Console The page emitted console output, including ordinary console calls, warnings, or page-error-related messages. Message text and context. Do not assume every console event is fatal.
Error The page crashed. Crash details and page or navigation context.
RequestFailed A network request failed at the request lifecycle level, for example because of a timeout. Request URL and failure text.
Response with status 400 or higher The server returned an HTTP error status. The request can still complete normally. Response status and URL.

Puppeteer-Sharp describes itself as a .NET port of the official Node.js Puppeteer API. It has multiple package variants, and event argument details can vary by release. Check the API documentation matching the package version in your project before relying on a member name or copying sample code.

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

Catch navigation failures separately

GoToAsync is an operation, not a general-purpose subscription for every issue that occurs after the page starts running. Its documentation describes navigation as either throwing or returning a main-resource response. Handle those outcomes as separate diagnostic paths: catch a thrown navigation exception, and, when a response is returned, inspect its status as appropriate.

#1 Best Overall
Dell Optiplex 7050 SFF Desktop PC Intel i7-7700 4-Cores 3.60GHz 32GB DDR4 1TB SSD WiFi BT HDMI Duel Monitor Support Windows 11 Pro Excellent Condition(Renewed)
  • Model: Dell OptiPlex 7050 Small Form Factor (SFF)
  • Processor: Intel Core i7-7700 3.60 GHz
  • Memory: 32GB DDR4 Ram
  • Storage: 1TB Solid State Drive (SSD) Fast Boot + Storage
  • Operating System: Windows 11 Pro (64-bit)

Typical causes of a thrown navigation failure include an invalid URL, SSL trouble, a navigation timeout, or a server that cannot be reached or does not respond. A successful navigation call does not prove that every script, image, or later request succeeded, nor does it prove that the application rendered correctly.

  • Log the target URL and exception when GoToAsync throws.
  • When a response is returned, record its status and URL if HTTP status matters to your workflow.
  • Use page and request events to diagnose failures that happen within or after an otherwise successful navigation.

Use PageError for uncaught JavaScript exceptions

PageError is the event for an uncaught exception inside the page. Its event arguments expose Message and a raw Error value. Preserve both where possible: the message is useful for human-readable logs, while the raw value may carry additional information.

Do not assume Error is always a conventional .NET exception or contains a stack trace. Page code can throw a primitive or another value, and the raw value may be a string, another object, or null. Logging code should therefore tolerate null and unexpected types rather than casting blindly.

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.

Read Console output as diagnostics, not a failure verdict

Console reports calls to the page’s console API and can also be emitted for page errors or warnings. It is useful when diagnosing application behavior, but it is broader than a fatal-error event. A message logged with console.info, for example, should not automatically trigger the same alert or retry policy as an uncaught exception.

Rank #2
Apple 2026 MacBook Neo 13-inch Laptop with A18 Pro chip: Built for AI and Apple Intelligence, Liquid Retina Display, 8GB Unified Memory, 256GB SSD Storage, 1080p FaceTime HD Camera; Blush
  • AN AMAZING MAC AT A SURPRISING PRICE — With an incredibly portable and durable aluminum design, up to 16 hours of battery life,* and the A18 Pro chip, MacBook Neo is ready to go wherever school takes you.
  • FOUR STUNNING COLORS. ONE DURABLE DESIGN — Choose from four beautiful colors — Silver, Blush, Citrus, or Indigo — each with a color-coordinated keyboard. And MacBook Neo is made with a durable recycled aluminum enclosure that helps it reach 60 percent recycled content by weight — the most ever in any Apple product.*
  • FLY THROUGH EVERYDAY ASSIGNMENTS — Whether you’re cramming for finals, using Apple Intelligence* to summarize class notes, creating presentations, or even playing the latest Apple Arcade game,* MacBook Neo delivers the performance and AI capabilities you need to get things done.
  • UP TO 16 HOURS OF BATTERY LIFE — MacBook Neo delivers all day battery life, so you can power through from early morning classes to late night study sessions without worrying about plugging in.
  • A VIBRANT 13-INCH DISPLAY* — The gorgeous Liquid Retina display on MacBook Neo supports 1 billion colors, so photos and videos pop and text is crisp for easy reading.

Capture the console message and, if your package exposes additional message metadata that you need, verify those members in the version-specific API reference. Decide in your own logging or monitoring layer which message types warrant escalation.

Keep page crashes distinct from page exceptions

The page’s Error event is documented as the signal raised when the page crashes. It is distinct from PageError, which signals an uncaught exception within the page. A JavaScript exception may indicate an application bug while the page continues to run; a crash is a different condition and should be diagnosed and handled accordingly.

Distinguish failed requests from HTTP error responses

RequestFailed is for a request that fails in the network request lifecycle, such as a timeout. The request interface exposes failure text that can help explain what happened. Request lifecycle events generally move through request, response, and request-finished; a redirect finishes one request and initiates another.

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

An HTTP status such as 404 or 503 is different. Upstream Puppeteer documents that HTTP error responses are still successful responses from the HTTP standpoint: the request can finish with requestfinished, not requestfailed. Therefore, a handler for RequestFailed alone will not catch every unsuccessful page resource or document response. Inspect response status codes as well.

Rank #3
Sale
HP Essential 2026 Laptop Student Business, Ultra Light, 4GB RAM, Intel CPU
  • Performance: Powered by Intel Celeron N4500 dual-core processor with up to 2.8 GHz burst frequency and 4MB L3 cache, this HP Chromebook delivers smooth multitasking for everyday computing. With 4GB LPDDR4x-2933 RAM and Intel UHD Graphics, enjoy seamless web browsing, video streaming, and productivity apps. Chrome OS boots in seconds and updates automatically, keeping your laptop secure and running at peak performance for students, professionals, and home users.
  • Immersive 14-Inch HD Display: Experience clear, vibrant visuals on the 14-inch diagonal HD (1366 x 768) anti-glare display with 250 nits brightness and 62.5% sRGB color accuracy. The micro-edge design maximizes your viewing area with an impressive 80% screen-to-body ratio, perfect for streaming movies, video calls, and document editing. The anti-glare coating reduces eye strain during extended use, making it ideal for all-day productivity and entertainment in any lighting condition.
  • Advanced Connectivity & Ports: Stay connected with Wi-Fi 6 (2x2) for faster wireless speeds and Bluetooth 5.3 for seamless device pairing. Equipped with versatile ports including 1 USB Type-C 10Gbps (with USB Power Delivery and DisplayPort 1.4), 2 USB Type-A 5Gbps ports, 1 HDMI 1.4b, and 1 headphone/microphone combo jack. Connect external monitors, transfer files quickly, charge your device, and expand your workspace effortlessly for maximum productivity and flexibility.
  • All-Day Battery & Premium Design: The battery keeps you powered throughout your day, while the included 45W USB Type-C power adapter ensures fast charging. Featuring a sleek modern grey finish with vertical brushing pattern on the keyboard deck, this lightweight 3.35 lb Chromebook combines style and portability. The full-size modern grey keyboard and HP Imagepad provide comfortable typing and precise navigation for work, school, or entertainment on the go.
  • Enhanced Security & Multimedia: Built-in H1 secure microcontroller protects your data and privacy with enterprise-grade security. The HP True Vision 720p HD camera with integrated dual array digital microphones delivers crystal-clear video calls and online meetings. HD Audio with stereo speakers provides rich, immersive sound for music, videos, and calls. With 64GB eMMC storage, you have ample space for essential files while Chrome OS seamlessly integrates with Google Drive for cloud storage.
  • Use RequestFailed to investigate transport or request-lifecycle failures.
  • Use Response status inspection to detect HTTP error responses such as 404 or 503.
  • Consider redirects as a chain of requests rather than one request whose URL simply changes.

Illustrative C# logging pattern

The following combines the major signals in one place. It is an illustrative pattern, not a tested snippet: confirm event argument member names and logging overloads against the Puppeteer-Sharp package version used by your project.

page.Console += (_, e) =>
    logger.LogInformation("Browser console: {Message}", e.Message.Text);

page.PageError += (_, e) =>
    logger.LogError("Uncaught page exception: {Message}; raw error: {Error}",
        e.Message, e.Error);

page.Error += (_, e) =>
    logger.LogError(e.Error, "Page crashed");

page.RequestFailed += (_, e) =>
    logger.LogWarning("Request failed: {Url}; {Failure}",
        e.Request.Url, e.Request.FailureText);

page.Response += (_, e) =>
{
    if (e.Response.Status >= 400)
        logger.LogWarning("HTTP error response: {Status} {Url}",
            e.Response.Status, e.Response.Url);
};

Attach handlers before navigating if you need to observe events that may occur during initial page loading. Keep the handlers focused on recording diagnostics; make retry or alert decisions using the signal’s meaning rather than treating all events as equivalent.

Troubleshoot common error-reporting gaps

“RequestFailed did not report a 404”

That is expected: a 404 is an HTTP response and can complete successfully at the request lifecycle level. Inspect response status codes, including the main navigation response and any subresource responses relevant to your task.

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

“The page is broken, but PageError did not fire”

PageError concerns uncaught JavaScript exceptions. A server response with an error status, a blocked request, an application-rendering defect that does not throw, or a navigation failure may require other signals. Check the navigation result, console messages, response statuses, and request failures independently.

Rank #4
Dell Optiplex 3060 Desktop Computer | Intel i5-8500 (3.2) | 32GB DDR4 RAM | 1TB SSD Solid State | Built in WiFi | Bluetooth | Windows 11 Professional | Home or Office PC (Renewed)
  • [INTEL POWERED CONTENT] - Built with a 8th Generation Hexa-Core Intel i5 and 32GB of DDR4 RAM; Modern, Windows 11 ready, with 4K support, Executive multitasking, media streaming and smooth, multi-tab web browsing; Perfect as an all-purpose multimedia computer; built for content creators; Plenty of RAM and Mass storage for photo and video editing powered by Intel HD 630
  • [LATEST WIRELESS TECH] - This Dell Desktop Computer easily connects to the internet through the Built In WiFi / Bluetooth
  • [SOLID STATE STORAGE] - This Dell Computer setup comes with an ultra-fast 1TB Solid State Drive (SSD); Setup as the primary boot device; Boot and load programs with lightning speed ; Additional expansion available
  • [BUY & OWN WITH CONFIDENCE] - From the world's largest Microsoft Authorized Refurbisher; Quality Guarantee and Free Tech Support; Award-winning Customer Service; | Support Sustainable Business
  • [MODERN HI-SPEED PORTS] - USB 3.0 (x4) | USB 2.0 (x4) | DisplayPort (x1) | HDMI Port (x1) | Audio Combo Jack (x1) | Audio Out (x1) | RJ-45 Ethernet (x1) | Internal SATA (x3)

“Console reports an error, but the run should not fail”

Console output includes a range of page messages and warnings. Log it for context, then apply a policy that distinguishes message types and severity instead of failing every run whenever a console event occurs.

“The exception has no useful .NET stack trace”

The raw page error is not guaranteed to be a .NET exception. Preserve the supplied message and raw value without assuming a particular CLR type; consult the matching package API documentation for the exact event argument shape.

“A resource timed out, but navigation completed”

The main document can load even when a later or secondary request fails. Use RequestFailed and record its URL and failure text rather than inferring that every request succeeded from the navigation result.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
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 goal is to capture a clean screenshot rather than build a browser-automation pipeline, ScreenshotNeo offers a screenshot API and MCP server. One GET request can return a PNG, JPEG, WebP, or PDF. Its API can accept consent banners as a visitor and remove more than 60 known consent platforms, newsletter popups, and chat widgets before capture; those steps can be turned off. Bot checks and CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, with response headers indicating the page verdict and whether the shot was billed. AI agents can use its MCP server tools, including take_screenshot, get_page_info, and capture_pdf.

For example, save a WebP screenshot of Stripe with cURL:

Best Value
Dell OptiPlex Computer Desktop PC, Intel Core i5 3rd Gen 3.2 GHz, 16GB RAM, 2TB HDD, New 22 Inch LED Monitor, RGB Keyboard and Mouse, WiFi, Windows 11 Pro (Renewed)
  • 🖥POWERFUL PROCESSOR and SUPERIOR STORAGE: Configured with top of the Intel Core i5 processor for lightning-fast, reliable and consistent performance to ensure an exceptional PC experience. 16GB RAM memory to smoothly run multiple applications and browser tabs all at once. 2TB HDD storage space to store apps, games, photos, music, and movies. Loaded with 16GB to zip through multiple tasks in a hurry without lag.
  • 🖥️New 22 Inch Full HD (1920x1080) LED monitor: with 75hz, High-Quality panel with quick refresh rate and response time. With 1080p resolution, you can enjoy gaming or a modern computing experience. 22 Inch monitor has a Smart Contrast to provide optimized image quality. Bezel-less and sleek design with glossy finish, crisp edge-to-edge visuals. Wide Viewing Angles for clarity from any viewpoint. VESA Mountable and built-in tilt options allow for a variety of monitor configurations.
  • ⌨️ +🖱️ RGB KEYBOARD AND MOUSE | RGB SPEAKER: 3 LED Colors - Blue, red, green, Backlight LED Lights for use at night time, looks amazing. The keyboard mouse and speaker are responsive, reliable, and probably plastered in RGB lights. It's important you pick the right one for your desktop.
  • 💿 WINDOWS 10 Pro LATEST: A new installation of the latest Microsoft Windows 11 Professional 64 Bit Operating System software, free of bloatware commonly installed from other manufacturers. As Microsoft's latest and best OS to date, Windows 10 Pro 64 Bit will maximize the utility of each PC for years to come. Optional software such as Anti-Virus and Office 365 can also be easily downloaded through the Microsoft Windows App Store.
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 request options. You can also make the same request with Python:

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)

Or with 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}`);

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

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.

Frequently Asked Questions

Which Puppeteer-Sharp event reports an uncaught JavaScript exception?

Use PageError; it is distinct from console output and the page-crash Error event.

Does RequestFailed catch HTTP 404 and 503 responses?

No. Those are HTTP responses, so inspect response status codes as well as subscribing to RequestFailed.

Can I assume PageErrorEventArgs.Error is a .NET exception?

No. It may be a string, another object, or null, so preserve it without assuming a CLR exception type.

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.