DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober 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 desk6 min

How to Retry Failed URLs in a Bulk Screenshot Script

Use a bounded retry loop for each URL, record the failure stage, and continue through the batch without rerunning successful captures.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Retry each URL independently—not the whole batch. Give each URL a finite attempt budget, record what failed and at which stage, and then continue to the next URL. This way, a temporary navigation problem does not force you to repeat successful captures, while persistent failures remain visible in your results.

Retry one URL at a time

Put the complete capture operation for a single URL inside its own retry loop. Keep the browser and other reusable resources outside the loop when appropriate, but isolate page state if reusing it could carry cookies, navigation state, or other unwanted effects between URLs.

As an Amazon Associate I earn from qualifying purchases.

Track each URL’s attempt number, failure stage, error, final URL when available, output path, and final status. A navigation timeout, a readiness timeout, a screenshot error, an HTTP error response, and an application error are different outcomes. Preserving those distinctions helps you decide what to retry and what to investigate.

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.

The policy below is framework-neutral. The Playwright examples later in this article are specific to Playwright; check the documentation for your installed version before copying API details into a script.

#1 Best Overall
Sale
KAMRUI Pinova P2 Mini PC 16GB RAM 512GB SSD, AMD Ryzen 4300U(Beats 5400U/3500U/N95,Up to 3.7GHz,4C/8T) Mini Computers,Triple 4K Display/HDMI+DP+Type-C/WiFi/BT for Home/Business Mini Desktop Computers
  • 【AMD Ryzen 4300U True 4-Core CPU: Outperforms N95 & i3-10110U】KAMRUI P2 Mini PC is equipped with true 4-core AMD Ryzen 4300U processor built on advanced 7nm Zen2 architecture,This means you get consistent, unthrottled performance for hours on end, whether you’re running multiple browser tabs, streaming 4K content, or managing virtual machines. Compare that to Intel N95 (4 efficiency cores that throttle under load) or Intel i3-10110U (only 2 cores total), and the difference is night and day: The KAMRUI P2 AMD Ryzen 4300U (28W) is 40% faster than the Intel i3-10110U and 25% faster than the Intel N95 in multi-core tasks, ensuring smooth, lag-free performance even during heavy workloads.
  • 【Integrated AMD Radeon Graphics: 2.5X Stronger for Tri 4K】The KAMRUI P2 AMD 4300U Mini PC have unlocked the full potential of the built-in AMD Radeon Vega 5 graphics with 28W power delivery, making it 2.5 times stronger than the Intel UHD graphics found in the N95 and i3-10110U. This means you can enjoy Tri 4K@60Hz displays without a single stutter, perfect for productivity setups, home theaters, or even light photo/video editing and casual gaming. While the Intel N95/i3-10110U struggle to run a single 4K display without lag, The KAMRUI AMD 4300U Mini PC handles Tri 4K effortlessly, turning your workspace into a high-efficiency hub or your living room into a premium entertainment center.
  • 【Large Storage Capacity, Easy Expansion】KAMRUI Pinova P2 mini computers is equipped with 16GB LPDDR4 for faster multitasking and smooth application switching. 512GB M.2 SSD ensures fast startup, fast file transfers and plenty of storage space,eliminating slow loading times and ensuring fast responsiveness. the two storage slots (1x M.2 2280 SATA/NVMe PCIe3.0 slot, 1x M.2 2280 SATA slot) can be combined to provide up to 4TB of total storage(Not included). This gives you enough space for all your projects, media and data.
  • 【4K Triple Display】KAMRUI Pinova P2 4300U mini desktop computers is equipped with HDMI2.0 ×1 +DP1.4 ×1+USB3.2 Gen2 Type-C ×1 interfaces for faster transmission, Triple 4K@60Hz Display, KAMRUI P2 mini computer is ideal for visual home entertainment, home office, conference rooms, etc. USB3.2 Gen2 Type-A port ×2 with a transfer speed of up to 10 Gbps (21 times faster than USB 2.0) for efficient data transfer. Ideal for seamless multitasking between spreadsheets, browsers and presentations, or for an immersive entertainment experience.
  • 【USB3.2 Gen2 Type-C 10Gbps, Versatile connectivity】KAMRUI P2 mini desktop pc fast and versatile connectivity! The USB3.2 Gen2 Type-C port offers a data transfer rate of 10Gbps and simultaneously supports DisplayPort 1.4 video output. The P2 AMD Ryzen 4300U Mini PC is complemented by Gigabit LAN, WiFi and Bluetooth, so nothing stands in the way of a productive working environment.

Decide which failures should be retried

Outcome Suggested handling
Navigation timeout or transport/navigation error Often transient. Retry within the configured limit, retaining the error from each attempt.
Readiness-condition timeout First check whether the condition matches the page state you need. Repeating an unsuitable wait usually repeats the same failure.
Screenshot operation error Record it as a capture-stage failure, separately from navigation. For example, a locator screenshot can fail if its target detaches.
HTTP error response or rendered application error Decide whether it is a failed URL based on the job’s goal. A page can load and be captured even when its destination returns an HTTP error or displays an error page; inspect the response or content if that matters.
Invalid URL or deterministic configuration error Usually record and move on rather than retry, unless you have evidence the condition can change.

A successful screenshot does not necessarily mean the page itself is healthy. Define separately whether your job cares about capture success, destination response status, or expected page content.

Set an explicit attempt budget and delay

Use a finite number of attempts and a deliberate delay between eligible retries. Choose both based on observed failures, total job duration, and the destination sites’ constraints; there is no universal retry count or delay established by Playwright’s documentation. In concurrent batches, increasing delays and jitter can reduce synchronized retry bursts.

When a URL exhausts its budget, keep its last error and continue with the next URL. Do not let a permanent problem block the rest of the batch, and do not retry forever. Report a URL that eventually succeeded as recovered after retry rather than as an immediate success.

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

Choose a page-specific readiness condition

Navigation completion and screenshot readiness are not the same thing. A document-load event does not guarantee that a client-rendered component, image, or other content you need has appeared. Wait for a condition connected to the screenshot’s purpose, such as the presence of a particular element or text.

Playwright documents navigation wait states, including commit, which considers navigation complete when a response is received and the document has started loading. Its Page API discourages using networkidle as a testing readiness condition and recommends web assertions instead: Playwright Page API. A page with analytics, polling, or long-lived connections may not become idle in a useful way; repeated network-idle waits can turn a readiness problem into repeated timeouts.

Keep output safe and results auditable

  • Write each attempt to a temporary or attempt-specific file. Promote it to the canonical output name only after capture succeeds, so a partial failure does not replace a prior good screenshot.
  • Define what happens if a successful screenshot already exists: skip it, overwrite it only after a new successful capture, or save a versioned result.
  • Write a manifest with the input URL, attempts made, final status, captured path, and concise failure detail. Include a distinct recovered-after-retry status so transient instability is not hidden.
  • Keep the failure stage in the manifest—navigation, readiness, screenshot, or validation—rather than reducing every problem to “URL failed.”

What Playwright’s retry features do—and do not do

Playwright’s Page API handles navigation and screenshot operations separately, so a script can record which stage failed. Locator screenshots wait for actionability, scroll the element into view, and can throw if the target detaches. The Python locator API also documents screenshot timeout behavior: Playwright Python Locator API.

Rank #2
Sale
GMKtec Mini PC, G3 Ultra Intel Pentium Gold 7505 16GB LPDDR4 RAM 512GB SSD
  • WHY CHOOSE G3 ULTRA MINI PC PENTIUM GOLD 7505 - Choose the Intel Pentium Gold 7505 for snappier everyday responsiveness: It delivers up to 30% faster single-core performance than the Ryzen 5 3500U, making office apps and web browsing feel noticeably quicker, while its Intel UHD Graphics (48 EUs) provides 2.4x the GPU performance of the N100 & N150's 24-EU graphics, ensuring smoother 4K streaming and light photo editing.
  • 16GB RAM MEMORY & 512GB STORAGE - GMKtec Nucbox G3 Ultra mini computer is prebuilt with 16GB LPDDR4 RAM at 3200 MT/s, you will enjoy a speedier experience with Built-in 512GB M.2 SATA Hard Drive. Our mini desktop pc boots up in seconds, work on multiple browser tabs, software applications and quickly transfers files. There is a primary slot and secondary expansion storage. Primary slot is M.2 2280 PCIE and secondary slot is M.2 2280 SATA.
  • RICH INTERFACE - Nucbox pentium mini computer is equipped with 3* USB 3.2 Gen2 ports, up to 10Gbps/S, 1*USB 2.0, HDMI(4K@60Hz)*2, 3.5mm Audio Jack. Supports WiFi 6, and Gigabit Ethernet RJ45 2.5GbE network connectivity, Bluetooth 5.2. This Mini PC supports multiple device connection and can be used with servers, monitoring equipment, office equipment, displays, projectors, televisions, etc.
  • 4K DUAL SCREEN DISPLAY - Mini desktop computer is equipped with upgraded Intel Graphics(max 1000MHz), supports 4K video playback and AV1 decoding, connect the pc with a projector as a home theatre, enjoy a variety of entertainments. Two HDMI 2.0 ports allows you to multi-task efficiently on two 4K@60Hz displays.
  • UPGRADED COOLING FAN - The G3 Ultra has upgraded the cooling fan to reduce fan noise and thermals. We are using an upgraded thermal paste as well to help reduce heat on the CPU.

Playwright Test has a retry mechanism for tests, not a ready-made policy for retrying only failed URLs in a standalone bulk capture script. Its testInfo.retry value is zero on the initial run and increments on retries; a test that fails and then passes is described as flaky: Playwright Test retries. For a URL list, an explicit per-URL loop is the direct way to avoid rerunning successful URLs.

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

For readiness conditions in Playwright Test, web-first assertions retry until the assertion passes or its timeout is reached: Playwright assertions. Prefer a meaningful assertion over adding repeated fixed sleeps without first identifying what the screenshot needs to wait for.

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

Troubleshoot common retry problems

The same URL fails on every attempt

Inspect the recorded stage and error. If the failure is a readiness timeout, verify the selector or assertion against the page’s actual rendered state. If it is an invalid URL or deterministic configuration issue, fix that cause rather than spending the remaining attempts on it.

A timeout happens after navigation succeeds

Separate navigation completion from readiness and capture in the log. The page may have started loading successfully while the specific content you need never appeared, or the screenshot operation itself may have failed. Preserve the last error and the relevant stage.

The job hangs waiting for network idle

Choose a page-specific signal for the content in the screenshot instead. Playwright explicitly discourages networkidle as a testing readiness condition; a page assertion is more useful when you know what must appear.

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

A recovered URL makes the batch look clean

Keep recovered-after-retry as a distinct outcome in logs and the manifest. The capture succeeded, but the initial failure is still useful evidence of instability.

Rank #3
Sale
GMKtec G3S Mini PC Intel N95 Processor (Up to 3.4GHz) 8GB RAM 256GB M.2 SSD
  • 12th Intel Alder Lake N95 Processor – The GMKtec G3 S Mini PC is powered by the 12th Gen Intel N95 processor with 4 cores, 4 threads, 6MB cache and a burst frequency up to 3.4GHz. Compared with N100/N5105/N5100/N5095, the N95 delivers up to 36% overall performance improvement. Perfect for routine tasks, office work, and home entertainment, this compact mini desktop is more convenient than traditional bulky PCs.
  • 8GB RAM & 256GB SSD Storage – Pre-installed with 8GB DDR4 memory and a fast 256GB M.2 2242 SSD, the G3 S mini desktop offers quicker startup, smoother multitasking, and faster file transfers. Enjoy seamless performance whether you’re working on multiple applications, browsing, or streaming content.
  • Rich Interfaces & Connectivity – The G3 S mini computer comes equipped with USB 3.2 (up to 10Gbps), dual HDMI 2.0 (4K@60Hz), and a 3.5mm audio jack. With support for WiFi 5, Bluetooth 5.0, and Gigabit Ethernet (RJ45 1000MbE), it connects easily with monitors, projectors, printers, office equipment, and other peripherals, making it versatile for both home and business use.
  • Dual 4K Display Support – Featuring upgraded Intel UHD Graphics (up to 1000MHz), the G3 S supports 4K video playback and AV1 decoding for a smooth viewing experience. With dual HDMI outputs, you can connect two 4K@60Hz displays simultaneously, enabling efficient multitasking for work and entertainment.
  • GMKTEC WARRANTY - GMKtec offers a 3-year limited warranty (1 year replacement + 2 years parts replacement) for each mini PC, starting from the date of the purchase effective on all sales starting Oct. 2026. All defects due to design and workmanship are covered. With a professional after sales team always ready to attend to your needs, you can simply relax and enjoy your mini PC

A failed attempt damages an existing image

Save to a temporary or attempt-specific path first and update the canonical path only when capture succeeds. Make the overwrite policy explicit so a failed retry cannot destroy a prior good artifact.

Or skip the browser setup

ScreenshotNeo provides a screenshot API and MCP server. A single GET request can return a PNG, JPEG, WebP, or PDF. For a capture request, its response includes page-verdict and billing headers; bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing. That billing behavior is specific to ScreenshotNeo and does not replace your own per-URL retry policy or manifest.

Cookie banners are accepted before capture and more than 60 known consent platforms, newsletter popups, and chat widgets are removed; each step can be turned off. Its MCP server provides take_screenshot, get_page_info, and capture_pdf for Claude, Cursor, and other MCP clients. The free plan includes 1,000 shots per month with no card; paid plans start at $5 for 3,000 shots. See the ScreenshotNeo API documentation.

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

cURL:

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

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)

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

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

Frequently Asked Questions

How do I retry only the URLs that failed?

Wrap the capture operation in a loop for each URL and retain successful results so the batch can continue without repeating them.

How many times should a screenshot script retry a timeout?

There is no universal count in the cited Playwright documentation. Set a finite budget based on observed failures, job duration, and the destination sites’ constraints.

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
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

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.