To automatically retrieve a document, automate the whole transaction—not just the click: open the page, wait for the browser’s download event while triggering the link or button, save the download to a deliberate path, then validate the file before closing the browser context. Playwright’s documentation warns that downloads are temporary and are deleted when their producing context closes, so an unsaved download is not a durable result.
This guide shows a repeatable workflow, runnable examples, execution choices, security boundaries, and recovery steps for sites that permit automated access.
The download workflow that actually leaves a file behind
A browser navigation and a file download are different events. A page can display a PDF in an embedded viewer, replace the current URL, or start a download only after JavaScript runs. Your automation should therefore model these stages explicitly:
- Identify the source and document. Use stable text, an accessible role, a known URL, or a selector that represents the document rather than a fragile CSS path.
- Arm the download listener first. Start waiting for the download before clicking. Fast responses can otherwise complete before your script begins listening.
- Trigger the supported action. Click the download control, submit the form, or perform the site’s documented navigation.
- Persist the artifact. Call the download object’s save method with your own destination path before closing the browser context.
- Validate and record. Check the filename pattern, extension, size range, and—where practical—whether a parser can open the file. Record the source URL, retrieval time, expected document identity, and outcome without retaining credentials unnecessarily.
The event and persistence behavior are documented by Playwright’s downloads guide.
Free tools Windows power users keep installed
One-click scans. No signup required.
#1 Best Overall
- PORTABLE SCANNER FOR USE ON-THE-GO — The fastest and lightest mobile single-sheet-fed compact document scanner in its class¹
- QUICK DOCUMENT SCANNING ― This Epson ultra-fast scanner scans a single page as quickly as 5.5 seconds²; Windows and Mac compatible
- VERSATILE PAPER HANDLING ― Portable scanner scans documents up to 8.5 x 72 in; Also easily digitizes receipts and ID cards to make accounting, bookkeeping, and organizing simpler
- INTUITIVE, HIGH-SPEED SOFTWARE — Epson ScanSmart Software³ is a smart tool allowing you to easily scan, review, and save; Stay organized easily with the help of this Epson scanner
- EASY SETUP — USB-powered connect to your computer for quick and simple scanning; No batteries or external power supply required to operate portable document scanner; Standard Connectivity: USB 2.0
Playwright: a complete Node.js example
Install a pinned Playwright version and its matching browsers, then run this script. The example creates an output directory, waits for a download before clicking, saves it, and performs basic checks.
npm install playwright
npx playwright install chromiumimport { chromium } from 'playwright';
import { mkdir, stat } from 'node:fs/promises';
import path from 'node:path';
const pageUrl = 'https://example.com/reports';
const outputDir = path.resolve('downloads');
const browser = await chromium.launch({ headless: true });
const context = await browser.newContext({ acceptDownloads: true });
const page = await context.newPage();
try {
await mkdir(outputDir, { recursive: true });
await page.goto(pageUrl, { waitUntil: 'domcontentloaded', timeout: 60_000 });
const downloadPromise = page.waitForEvent('download', { timeout: 60_000 });
await page.getByRole('link', { name: /annual report/i }).click();
const download = await downloadPromise;
const suggested = download.suggestedFilename();
if (!/.(pdf|docx?|xlsx?)$/i.test(suggested)) {
throw new Error(`Unexpected filename: ${suggested}`);
}
const destination = path.join(outputDir, suggested);
await download.saveAs(destination);
const info = await stat(destination);
if (info.size === 0) throw new Error('The saved file is empty');
console.log(`Saved ${destination} (${info.size} bytes)`);
} finally {
await context.close();
await browser.close();
}Replace the URL and accessible name with controls on the site you are authorized to use. Prefer role- or label-based locators; they survive visual redesigns better than generated class names. If the site opens a menu first, perform that action before arming the listener, then arm it immediately before the final download trigger.
Python Playwright version
Python teams can use the same event ordering and explicit persistence.
pip install playwright
playwright install chromiumfrom pathlib import Path
from playwright.sync_api import sync_playwright
page_url = "https://example.com/reports"
out = Path("downloads")
out.mkdir(exist_ok=True)
with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
context = browser.new_context(accept_downloads=True)
page = context.new_page()
try:
page.goto(page_url, wait_until="domcontentloaded", timeout=60_000)
with page.expect_download(timeout=60_000) as waiting:
page.get_by_role("link", name="Annual report").click()
download = waiting.value
name = download.suggested_filename()
if not name.lower().endswith((".pdf", ".doc", ".docx", ".xls", ".xlsx")):
raise ValueError(f"Unexpected filename: {name}")
destination = out / name
download.save_as(destination)
if destination.stat().st_size == 0:
raise ValueError("The saved file is empty")
print(f"Saved {destination} ({destination.stat().st_size} bytes)")
finally:
context.close()
browser.close()The same rule applies in asynchronous Python: enter an expect_download() block before the click and call save_as() before closing the context.
Do these 3 things before closing this tab:
1Fix the driver behind crashes, sound loss and screen glitches2Repair Windows errors before they cause bigger problems3Scan for outdated or missing drivers - takes under a minuteWhen the “download” is really a document viewer
Some controls navigate to a PDF viewer instead of emitting a download event. First determine what the site actually does:
Rank #2
- FAST SPEEDS - Scans color and black and white documents a blazing speed up to 16ppm (1). Color scanning won’t slow you down as the color scan speed is the same as the black and white scan speed.
- ULTRA COMPACT – At less than 1 foot in length and only about 1. 5lbs in weight you can fit this device virtually anywhere (a bag, a purse, even a pocket).
- READY WHENEVER YOU ARE – The DS-640 mobile scanner is powered via an included micro USB 3. 0 cable allowing you to use it even where there is no outlet available. Plug it into you PC or laptop and you are ready to scan.
- WORKS YOUR WAY – Use the Brother free iPrint&Scan desktop app for scanning to multiple “Scan-to” destinations like PC, Network, cloud services, Email and OCR. (2) Supports Windows, Mac and Linux and TWAIN/WIA for PC/ICA for Mac/SANE drivers. (3)
- OPTIMIZE IMAGES AND TEXT – Automatic color detection/adjustment, image rotation (PC only), bleed through prevention/background removal, text enhancement, color drop to enhance scans. Software suite includes document management and OCR software. (4)
- If a click emits a download event, use the examples above.
- If it navigates to a document URL, capture that URL and use an authorized HTTP client only when the site’s policy and authentication model allow it.
- If the document is rendered inside an iframe or viewer, wait for the viewer’s own download control and listen for the resulting event.
- If content is generated after a form submission, wait for the specific response or selector that proves generation finished, then arm the download listener for the final action.
Do not assume that a visible PDF means the bytes have been saved. Validate the resulting file and preserve it in your controlled directory.
Authentication, consent and changing pages
Login state
Use a dedicated browser context and the site’s supported login flow. Persisting storage state can reduce repeated logins, but treat the state file as a credential: restrict permissions, keep it out of source control, and delete or rotate it when no longer needed.
Consent overlays
Cookie banners and modal overlays can intercept a click. Handle the site’s consent control when required, or use a locator that waits for the overlay to disappear. Do not bypass access controls or a site’s terms.
Selectors that survive redesigns
Use accessible roles, labels, stable data attributes, or a document identifier. Add a timeout and a clear error message rather than falling back to an unrestricted “click whatever is nearby” selector.
Retries without duplicate files
Use a per-attempt temporary name, then atomically move a validated file to its final name. Include a document ID or content hash in the name when the source can return revisions. Retry navigation and transient network failures with bounded backoff; do not blindly repeat a form submission that could create a new server-side job.
Validation and operational records
A successful event only proves that the browser reported a download. Before marking a job complete:
Rank #3
- FAST DOCUMENT SCANNING — Document scanner with feeder allows you to speed through stacks with a 50-sheet Auto Document Feeder (ADF); Efficient office scanner to help you scan more productively
- INTUITIVE, HIGH-SPEED SOFTWARE — Quickly scan with this desktop document scanner; Epson ScanSmart Software lets you easily preview scans, email files, upload to the cloud, and more; Plus, automatic file naming saves even more time
- SEAMLESS INTEGRATION — Easily incorporate your data into most document management software with the included TWAIN driver; Office document scanner integrates seamlessly with business workflows
- EASY SHARING — Duplex scanner allows you to scan straight to email or popular cloud storage2 services like Dropbox, Evernote, Google Drive, and OneDrive for simple storage and sharing
- SIMPLE FILE MANAGEMENT — Scanner allows the creation of searchable PDFs with Optical Character Recognition (OCR) and convert scans to editable Word or Excel files effortlessly; Designed for home and office document scanning
- Confirm the extension or MIME expectation and reject an HTML error page saved as “document.pdf.”
- Enforce reasonable minimum and maximum sizes for the document type.
- Open or parse the file with the appropriate library when correctness matters.
- Record source URL, retrieval timestamp, browser/engine version, output path, and a success or failure reason.
- Keep logs free of passwords, session cookies, authorization headers, and unnecessary document contents.
For parallel jobs, give each job an isolated context and unique output path. Limit concurrency to what your network, CPU, target site, and storage can sustain, and use explicit timeouts for navigation, downloads, and post-download validation.
Recommended Free Tools
Choosing an execution model
Local or self-hosted Playwright
Playwright is code-first and runs Chromium, Firefox, and WebKit, as well as branded Google Chrome and Microsoft Edge channels. Its browser documentation recommends installing the browsers that match your Playwright package and updating them deliberately. This model gives direct access to contexts, files, credentials, queues, and surrounding application code, but your team owns patches, capacity, observability, and network policy.
Robot Framework Browser
Robot Framework Browser provides keyword-driven workflows for teams that prefer readable test or business-process files. Its installation guide describes a Python library driving Playwright in Node.js, requires Python 3.10 or newer, and offers either bundled Node.js or a separately supplied installation.
Managed browser execution
Cloudflare’s Browser Run guide (updated May 29, 2026) separates stateless Quick Actions—such as screenshots, PDFs, and scraping—from Playwright, Puppeteer, or CDP-driven browser sessions. A one-off PDF or scrape may fit a stateless action; login-heavy, multi-step retrieval generally needs a session. Compare control, integration, state handling, network reachability, and who operates browser infrastructure. The available documentation does not establish a price or performance winner.
| Question | Local Playwright | Managed browser |
|---|---|---|
| Browser and code control | Direct contexts and application integration | API or hosted session boundary |
| Operational ownership | You install, patch and scale browsers | Provider operates browser infrastructure |
| Best fit | Interactive, stateful, custom workflows | Stateless actions or hosted sessions |
| Security boundary | Your process and outbound controls | Provider environment plus your input and credential controls |
Browser versions and restricted networks
Each Playwright release expects compatible browser binaries. After upgrading the package, install the corresponding browsers and test the exact operating system and engine used in production. Chromium, Firefox, WebKit, and branded Chrome or Edge are not interchangeable in every policy, codec, or platform behavior.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
Rank #4
- Scanner type: Document
- Connectivity technology: USB
- With Auto Scan Mode, the scanner automatically detects what you're scanning
- Digitize documents and images
Corporate environments may block browser downloads or outbound traffic. Playwright documents proxy settings, custom certificates, and custom browser-download hosts in its browser guide. Configure those deliberately, document the trust chain, and verify that the runtime can reach both the browser distribution and target sites.
Security boundaries you must design
A browser can reach every destination available to its process, including internal services. The Open Assistant browser-automation documentation warns that user-provided URLs must be validated. In a service that accepts URLs:
- Allow-list schemes and, where possible, hostnames.
- Block loopback, link-local, private and metadata IP ranges after DNS resolution, including redirects.
- Run the browser in an isolated worker with least-privilege credentials and restricted egress.
- Cap page count, download size, CPU time, and concurrent jobs.
- Scan or sandbox downloaded files before exposing them to other systems.
- Respect authentication requirements, robots or contractual policies, rate limits, and terms; automation does not override them.
Common failures and precise fixes
“The click worked, but no file exists”
Cause: the script never awaited the download or relied on the temporary folder. Fix: arm the event before clicking, await it, call saveAs(), and do so before context closure.
Timeout waiting for a download
Cause: wrong locator, a viewer navigation, blocked consent overlay, login expiry, or a site that does not download that control. Fix: inspect the resulting URL and page state, verify authentication, handle overlays, and identify the actual final download control.
Saved file is HTML or zero bytes
Cause: an error page, redirect, access-denied response, or incomplete persistence. Fix: check extension and size, inspect response/content type where available, save to a writable path, and validate by opening the document.
Best Value
- OUR MOST ADVANCED SCANSNAP. Large touchscreen, fast 45ppm double-sided scanning, 100-sheet document feeder, Wi-Fi and USB connectivity, automatic optimizations, and support for cloud services. Upgraded replacement for the discontinued iX1600
- CUSTOMIZABLE. SHARABLE. Select personalized profiles from the touchscreen. Send to PC, Mac, mobile devices, and clouds. QUICK MENU lets you quickly scan-drag-drop to your favorite computer apps
- STABLE WIRELESS OR USB CONNECTION. Built-in Wi-Fi 6 for the fastest and most secure scanning. Connect to smart devices or cloud services without a computer. USB-C connection also available
- PHOTO AND DOCUMENT ORGANIZATION MADE EFFORTLESS. Easily manage, edit, and use scanned data from documents, receipts, photos, and business cards. Automatically optimize, name, and sort files
- AVOIDS PAPER JAMS AND DAMAGE. Features a brake roller system to feed paper smoothly, a multi-feed sensor that detects pages stuck together, and skew detection to prevent paper damage and data loss
Browser executable is missing
Cause: Playwright package and browser binaries are out of sync or were not installed in the deployment image. Fix: run the matching install command during image build and pin versions.
Works locally, fails in production
Compare engine, OS, fonts, proxy, certificates, DNS, permissions, and headed versus headless behavior. Capture a trace or diagnostic log without storing secrets, then reproduce against the production browser version.
A research benchmark, not a product guarantee
The WebRobot paper reports that its system automated a majority of 76 web-RPA benchmarks; that 2022 result should not be read as a current success rate for Playwright or commercial services. It illustrates why document retrieval is a workflow-design problem rather than a guarantee that every site can be automated. Read the paper at arXiv:2203.09993.
Or skip the browser setup
For a direct screenshot or PDF of a public URL, ScreenshotNeo provides a one-request API and an MCP server for AI agents. It removes cookie/consent banners, newsletter popups and chat widgets before capture; bot checks, blank pages, failed loads, timeouts and cache hits are not billed. Its MCP tools include take_screenshot, get_page_info and capture_pdf.
Start with the ScreenshotNeo API documentation. cURL:
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://stripe.com -o shot.webpPython:
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}`);The free plan includes 1,000 screenshots each month with no card; paid plans start at $5 for 3,000. Create a free ScreenshotNeo account.
Frequently Asked Questions
Does Playwright save downloads automatically?
No. The browser keeps downloads in a temporary location; call the download object’s save method before the creating browser context closes.
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchWhich browser engine should I use?
Use the engine and operating system that match your deployment and target-site behavior, then pin and test that combination. Chromium, Firefox, WebKit and branded browsers can differ.
Can automation retrieve any website document?
No. Login state, consent, changing markup, network policy and site terms can prevent retrieval. Automation must respect access controls and supported policies.
Quick Recap
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.
