Automate screenshots by opening each page in a real browser, waiting until the content you need has rendered, and then saving a viewport, full-page, clipped, or element screenshot. Playwright and Puppeteer both support this workflow; a command-line option, shot-scraper, is built on Playwright. The key to dependable captures is not simply waiting for navigation to finish: wait for the specific content your job needs.
Choose a browser-based workflow
A screenshot records what a browser rendered at a particular time; it does not extract structured data from the page. If the target uses JavaScript, responsive layouts, or browser-dependent rendering, automation needs a browser context. For scraping jobs that also collect text or fields, use the DOM or an allowed API for that data and save screenshots as visual evidence or for review.
Playwright and Puppeteer expose similar core capture operations. Choose based on your existing language runtime and automation code, browser coverage, and the capture controls you need—not an assumed universal speed advantage. Their documentation describes capabilities, not a cross-site speed or reliability winner.
At a glance
| Need | Playwright | Puppeteer |
|---|---|---|
| Viewport | page.screenshot() |
page.screenshot() |
| Full scrollable page | fullPage: true |
fullPage: true |
| One element | Locator screenshot | ElementHandle.screenshot() |
| Region | clip |
clip |
| Notable output controls | Format, scale, masking, animation handling, and related options | Type, quality, encoding, transparent background, and related options |
Playwright documents its screenshot and Page APIs in its screenshot guide and Page API. Puppeteer documents screenshot capture in its screenshot guide and Page API. Chrome for Developers describes Puppeteer as a JavaScript library for automating Chrome and Firefox through Chrome DevTools Protocol and WebDriver BiDi in its Puppeteer overview.
#1 Best Overall
- 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.
Build a reliable capture pipeline
- Launch a browser. Headless mode is common for unattended jobs. Use a controlled browser lifecycle; close pages or contexts when finished, or deliberately reuse a browser for successive jobs.
- Set the viewport and device scale. Responsive breakpoints affect the rendered page. An explicit viewport makes repeated jobs more comparable.
- Navigate to the target URL. Navigation completing does not guarantee that client-rendered content is ready.
- Wait for the page state you need. Prefer a target selector, application event, or other known readiness condition. Network-state waits can help where appropriate, but a generic page-load event may precede data rendering.
- Capture the right scope. Save the visible viewport, entire scrollable document, a clipped region, or a single element according to the purpose of the image.
- Save or return the result. Write an image file or use the screenshot bytes in the next pipeline step.
- Record capture context. Keep the URL and capture time with the image so a reviewer can identify which rendered state it represents.
Automate captures with Playwright
Install Playwright in a JavaScript project and install the browser it will launch using the project’s Playwright setup. This example saves both the visible viewport and the entire scrollable document. Replace the example URL and selector with the target and a stable marker that appears when the relevant content is ready.
import { chromium } from 'playwright';
const browser = await chromium.launch();
try {
const page = await browser.newPage({
viewport: { width: 1365, height: 900 },
deviceScaleFactor: 1
});
await page.goto('https://example.com');
await page.locator('main').waitFor({ state: 'visible' });
await page.screenshot({ path: 'viewport.png' });
await page.screenshot({ path: 'full-page.png', fullPage: true });
const heading = page.locator('h1');
if (await heading.count()) {
await heading.screenshot({ path: 'heading.png' });
}
} finally {
await browser.close();
}The main selector is only an example: it may exist before the data of interest has loaded. Use a selector or application condition that corresponds to the actual content you need. If a full-page image is unnecessarily large, capture the relevant locator or a clip instead. Playwright also documents masking and animation controls for cases where dynamic visuals make repeated captures hard to compare.
Automate captures with Puppeteer
Install Puppeteer in a JavaScript project and use its browser setup for the environment. This example waits for a network-idle navigation state, saves the viewport, and captures an element if the selector exists.
import puppeteer from 'puppeteer';
const browser = await puppeteer.launch();
try {
const page = await browser.newPage();
await page.setViewport({ width: 1365, height: 900 });
await page.goto('https://example.com', { waitUntil: 'networkidle2' });
await page.screenshot({ path: 'page.png' });
const heading = await page.$('h1');
if (heading) {
await heading.screenshot({ path: 'heading.png' });
}
} finally {
await browser.close();
}networkidle2 is a navigation condition, not proof that a site’s application data is ready. For a page with delayed client-side rendering, wait for the relevant selector or other site-specific signal before taking the screenshot. Puppeteer also documents full-page capture, clipping, image type and quality, encoding, transparent backgrounds, and capture beyond the viewport in its screenshot options.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Rank #2
- 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.
Select viewport, full-page, element, or clip
Viewport capture
A regular screenshot captures the visible area at the chosen viewport. Use it when the page’s above-the-fold appearance is what matters or when a consistent fixed-size image is required.
Full-page capture
Set fullPage: true to capture the full scrollable document rather than only the visible viewport. This is useful for whole-page review, but can produce a tall image containing unrelated sections. Playwright describes this as capturing the full scrollable page as though it fit on a very tall screen.
Element capture
Capture a locator or element when the scrape concerns a particular card, chart, table, or result. It limits unrelated page content and often makes later review easier. Make sure the element is present and visible before capture.
Clipped capture
Use a clip rectangle when the required region is known by coordinates. Clipping avoids saving the rest of the page, but coordinates depend on the rendered layout; viewport changes or responsive breakpoints can move the target.
Rank #3
- 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.
Wait for the content, not just the page
Pages may render in stages: the document can load first, followed by client-side data, images, or a component that appears only after interaction. A screenshot taken between those stages may be technically successful but visually incomplete. Tie readiness to the scraped content: wait for a result container, a known heading, an application signal, or a deliberate delay only when the site gives no better condition.
- Use a semantic or stable selector. A role, stable attribute, or content marker is generally more robust than a fragile position-based selector.
- Check the state you actually need. Presence alone may be insufficient if the element is hidden or still empty; wait for visibility or for a meaningful content condition where your code can express it.
- Use network-idle waits selectively. Pages with long-lived requests or background activity may not reach an idle state promptly, while an idle network does not necessarily mean the desired content has rendered.
- Control motion when repeatability matters. Playwright exposes animation handling and masking options; Puppeteer provides its own screenshot controls. Choose the options that fit the capture rather than assuming an animated page will settle identically every run.
Run captures from the command line
shot-scraper is a command-line screenshot tool built on Playwright. It can suit shell scripts, scheduled captures, and documentation snapshots when a custom browser script would add unnecessary maintenance. Check the project’s documentation for its current installation and command syntax, then use it where its options match the same essentials: a controlled viewport, an appropriate readiness condition, and the capture scope you need.
Or skip the browser setup
For a single-request screenshot API, ScreenshotNeo accepts a URL and returns an image or PDF. Its clean-shot steps can accept cookie or consent banners and remove more than 60 known consent platforms, newsletter popups, and chat widgets; each step can be turned off. Bot checks or CAPTCHAs, blank pages, timeouts, failed loads, and cache hits cost nothing, and the response identifies the page verdict and billing status in headers. Its MCP server provides screenshot tools for AI agents, including Claude, Cursor, and other MCP clients.
Here is a cURL example that saves a WebP capture of a target URL:
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webpSee the ScreenshotNeo API documentation for authentication and request options. ScreenshotNeo also accepts the parameter names used by other screenshot APIs to ease switching. Its options include full-page capture with lazy images loaded, CSS-selector element capture, dark mode, 12 device presets or a custom viewport, retina scale, PDF controls, HTML/CSS-to-image, custom CSS and JavaScript, click-before-capture, selector hiding, selector/delay/network-idle waits, request and resource blocking, custom headers/cookies/user agent/Authorization, timezone and geolocation, transparent background, image resizing, configurable cache TTL, signed public image links, asynchronous jobs with signed webhooks, batches of up to 100 URLs per call, usage API, and an OpenAPI spec.
Rank #4
- 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
The free plan includes 1,000 screenshots per month without a card. Paid plans start at $5 for 3,000 shots; the other monthly tiers are Growth at $15 for 15,000, Pro at $39 for 60,000, Scale at $99 for 250,000, and Business at $249 for 1,000,000. Yearly billing gives two months free, and every feature is available on every plan. Learn about ScreenshotNeo, then sign up for 1,000 free screenshots a month with no card.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Troubleshoot incomplete or inconsistent screenshots
The screenshot is blank or missing client-rendered data
Likely cause: capture ran after navigation but before the target content rendered. Fix: wait for the relevant selector or application state, and verify that the element is visible and populated before capture.
A full-page capture is too tall or contains irrelevant areas
Likely cause: the entire scrollable document was captured when the task only needed one region. Fix: use a locator screenshot or a clip for the portion needed.
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 minuteThe same job produces different-looking images
Likely cause: a responsive breakpoint, animation, changing content, or timing difference altered the rendered state. Fix: fix the viewport and device scale, wait on a stable page condition, and use animation or masking controls where appropriate.
Best Value
- 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.
Element capture fails or targets the wrong content
Likely cause: the selector is absent, unstable, or matched before the correct component is ready. Fix: wait for a stable selector, confirm it identifies the intended element, and handle the case where it is not found rather than assuming every page has the same structure.
Navigation or readiness waits hang
Likely cause: the selected network condition never occurs, or the site keeps requests active. Fix: use a site-specific selector or readiness event instead of relying only on network idleness. Keep a bounded timeout in production code and log the URL and failed condition so the issue is diagnosable.
Plan for performance, reliability, and cost
The cited browser documentation does not establish a universal throughput figure, cost, or speed winner. Benchmark against your own target pages and expected concurrency: page complexity, assets, readiness waits, browser startup, image dimensions, and how many jobs run at once all affect the workload. Start with controlled concurrency, observe completion times and failure modes, and increase parallelism only after checking that the target and your runtime remain stable.
Free tools Windows power users keep installed
One-click scans. No signup required.
- Use viewport capture when a full document is unnecessary; smaller captures reduce irrelevant output.
- Reuse a controlled browser for batches when appropriate, while keeping page/context state isolated enough for your job.
- Set explicit viewports and record capture metadata for reproducibility.
- Retry only failures that may recover, and distinguish navigation/readiness failures from successful captures of an unexpected page state.
- Use screenshots as rendered-state evidence, not as a substitute for DOM extraction or an allowed data API.
Whether a site permits automated access, and what legal requirements apply, depend on the site and jurisdiction; the browser-tool documentation does not establish permission. Check the target site’s applicable terms and rules before running a scraping job.
Frequently Asked Questions
Can I capture screenshots from a browser automation script without saving a file?
Yes. Playwright supports returning screenshot bytes as a buffer, which can be passed directly to another step in a pipeline.
Does full-page capture scroll the page in the same way a person does?
It captures the full scrollable document as a tall screenshot; it is distinct from a screenshot of only the current viewport.
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.
