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

For a one-off screenshot after navigation, pass waitUntil: 'networkidle' to page.goto(), then call page.screenshot(). Playwright defines network idle as at least 500 ms with no network connections. It also discourages using this state as a test-readiness signal: a quiet network does not prove that the specific content you need is visible or finished rendering.

Capture a screenshot after navigation reaches network idle

Use this pattern when a brief network-quiet period is a suitable gate for your capture:

await page.goto('https://example.com', { waitUntil: 'networkidle' });
await page.screenshot({ path: 'screenshot.png' });

page.goto() accepts load, domcontentloaded, networkidle, and commit for waitUntil; its default is load. Playwright’s current Page API documentation defines networkidle as no network connections for at least 500 ms. The screenshot call is separate, so place it after the navigation wait.

This is a network condition, not a guarantee that all application work, rendering, or background activity has ended. Use it when the quiet interval itself is useful, not as a universal definition of “ready.”

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

Wait for network idle after navigation has started

If navigation is already underway or has committed, wait for the load state before capturing:

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

waitForLoadState() resolves immediately if the requested state has already been reached. Calling it after that point does not check whether a particular heading, result, or other application-specific content is ready.

Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.

For tests, wait for the content the screenshot needs

Playwright marks networkidle as discouraged for tests and says to rely on web assertions to assess readiness. In a test, identify the visible state that matters and assert it before taking the screenshot. For example, replace the heading and URL below with ones appropriate to your page:

await page.goto('https://example.com');
await expect(page.getByRole('heading', { name: 'Expected heading' })).toBeVisible();
await page.screenshot({ path: 'screenshot.png' });

The locator is an example, not a selector guaranteed to exist on every site. Choose a meaningful signal for the page’s intended state, such as the expected heading or a loaded result. Playwright’s writing tests guide covers locator-based interactions and assertions.

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.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

Use a screenshot assertion for visual regression tests

When the goal is to compare a page with an expected image in the Playwright Test runner, use toHaveScreenshot() after asserting that the required content is visible:

await page.goto('https://example.com');
await expect(page.getByRole('heading', { name: 'Expected heading' })).toBeVisible();
await expect(page).toHaveScreenshot();

Playwright’s screenshot assertion documentation says the assertion waits until two consecutive page screenshots match, then compares the last screenshot with the expectation. This is designed for screenshot comparison; it is not a substitute for asserting that the page contains the content your test requires.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

Animations and dynamic content can still make visual output vary. The screenshot assertion documentation describes disabling animations by default, and the visual comparisons guide demonstrates using a stylesheet to filter volatile elements. These measures can improve repeatability but do not eliminate every source of variation.

Choose the wait based on what “ready” means

Approach What it waits for Best fit Important limitation
goto(url, { waitUntil: 'networkidle' }) or waitForLoadState('networkidle') At least 500 ms without network connections, according to Playwright’s Page API A capture where a short network-quiet interval is an appropriate gate The API discourages it as a test-readiness strategy; network quiet does not establish application-specific readiness.
Locator assertion such as toBeVisible() The stated element becoming visible A test that needs particular content or a control to appear You must choose a locator that represents the desired page state.
expect(page).toHaveScreenshot() Two consecutive page screenshots matching before comparison with the expectation Visual regression tests using Playwright Test It addresses image stability for comparison; it does not guarantee that the correct application state was reached.

Avoid fixed sleeps as a readiness strategy

Playwright says page.waitForTimeout() should be used only for debugging. A fixed delay can be too short on a slow run and unnecessarily long on a fast one; it does not verify that the page reached the needed state. Prefer a load-state wait when network inactivity is the intended condition, or an assertion for a specific application or visual state.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Timeouts and common failure cases

Navigation, load-state waits, and screenshots have timeout controls, and Playwright provides page- and browser-context-level methods for changing default timeouts. There is no universal timeout that fits every application or infrastructure. Set one that accommodates the expected content and your environment, and investigate what is keeping the wait open rather than simply increasing it.

  • networkidle times out: the page may continue making network requests, so the quiet interval never occurs. If a specific element is what matters, wait for that element with an assertion instead.
  • The screenshot is missing content despite the wait succeeding: network silence did not represent the application’s readiness condition. Add an assertion for the required visible content before the screenshot.
  • waitForLoadState('networkidle') returns immediately: the state may already have been reached. That behavior is expected; add a separate application-specific assertion if the page needs more work.
  • Visual snapshots differ between runs: inspect animations and changing content. Consider Playwright’s screenshot options for animation handling or a stylesheet that filters volatile regions, while recognizing that other variation may remain.
  • A fixed delay seems inconsistent: replace it with a load-state wait or an assertion tied to the expected page state. Playwright classifies fixed timeout waits as debugging-only.

Or skip the browser setup:

ScreenshotNeo provides a screenshot API and MCP server. Its clean-shot process accepts cookie or consent banners like a visitor and removes more than 60 known consent platforms, newsletter popups, and chat widgets before capture; each of those steps can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits are not billed as clean shots, and responses include X-Page-Verdict and X-Billed headers. Its MCP server offers take_screenshot, get_page_info, and capture_pdf for Claude, Cursor, and other MCP clients. ScreenshotNeo offers 1,000 screenshots a month free without a card; paid plans start at $5 for 3,000 shots.

Make a GET request with the page URL to save a WebP screenshot:

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. The service supports PNG, JPEG, WebP, or PDF output, along with full-page and element captures, device and viewport settings, waits, custom CSS and JavaScript, request blocking, caching, and more. Visit ScreenshotNeo for product details, or sign up free for 1,000 screenshots a month with no card.

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

Frequently Asked Questions

Does network idle mean every image and script has finished rendering?

No. Playwright’s definition describes network connections, not completion of all rendering or application work. For required content, assert the page state you need.

Can I use toHaveScreenshot() outside Playwright Test?

The screenshot assertion is for the Playwright Test runner; use page screenshots and appropriate readiness checks in standalone scripts.

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.