DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowHalloween DealsAmazon USHalloween week deals: useful picks before month-endAmazon US: current deals, useful picks and tech finds.Check DealsWindows FixRecommendedWindows errors stealing your time? Find the fix fastScan stability, cleanup and performance issues.Fix Now×
Skip to content
Mountain View desk4 min

How to Capture a Website Screenshot with Puppeteer at Android Viewport Dimensions

Configure a Puppeteer device profile or explicit mobile viewport before navigating, then save a viewport screenshot with page.screenshot().
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Set Puppeteer’s mobile viewport or emulate a named Android device before opening the page, then call page.screenshot(). There is no single universal Android viewport: use a device profile when you want its configured metrics and user agent, or specify the CSS viewport dimensions that match your target.

Choose a device profile or explicit viewport

Puppeteer offers two practical ways to configure an Android-sized capture. A named device profile is convenient and applies that profile’s metrics and user agent. An explicit viewport gives you direct control over width and height. In either case, the selected values describe browser emulation; they do not verify rendering on a physical Android device.

As an Amazon Associate I earn from qualifying purchases.

Approach Use it when What it configures
KnownDevices with page.emulate() You want a named profile supplied by Puppeteer. Device metrics and user agent.
page.setViewport() You need to state and control the viewport dimensions directly. The values you provide, such as width, height, device scale factor, and mobile or touch settings.

The title does not specify a handset, so the example below uses Puppeteer’s Pixel 7 profile as an explicit choice—not as a universal Android standard. The official API documentation surfaced versions 25.11.0 and 25.12.0; check the documentation for the Puppeteer version installed in your project if you need version-specific confirmation: page.emulate(), page.setViewport(), and screenshots.

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

Capture a viewport-sized screenshot

Install Puppeteer in a Node.js project, save this as an ES module such as capture.mjs, and run it with node capture.mjs. Replace the example URL with the page you want to capture.

#1 Best Overall
Sale
Samsung Galaxy A17 5G Smart Phone 128GB US 1 Yr Manufacturer Warranty Black | Large AMOLED, High-Res Camera, Durable Design, Super Fast Charging, Expandable Storage, Circle to Search, 2025
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.
import puppeteer, { KnownDevices } from 'puppeteer';

const browser = await puppeteer.launch();
try {
  const page = await browser.newPage();

  // Option A: emulate a named profile supplied by Puppeteer.
  await page.emulate(KnownDevices['Pixel 7']);

  // Option B: set an explicit viewport instead. These example values are
  // illustrative; choose dimensions appropriate to your target.
  // await page.setViewport({
  //   width: 412,
  //   height: 915,
  //   deviceScaleFactor: 1,
  //   isMobile: true,
  //   hasTouch: true,
  // });

  await page.goto('https://example.com', { waitUntil: 'networkidle2' });
  await page.screenshot({ path: 'android-viewport.png' });
} finally {
  await browser.close();
}

With the default screenshot extent, Puppeteer captures the viewport. The output in this example is written to android-viewport.png. The screenshot options document other controls, including full-page capture, clipping, image type, quality, and background behavior.

Set the viewport before navigation

Configure emulation before page.goto(). Puppeteer notes that resizing can affect site behavior; changing mobile or touch settings may trigger a reload in some cases. Setting the target configuration first avoids capturing an initial page state under different metrics.

Rank #2
Tracfone Motorola Moto G 2025, 64GB, Saphire Blue (Locked to | Prepaid Smartphone- 6.6" 120Hz Display, 5G , 50MP Quad Pixel Camera, Long-Lasting Battery
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Tracfone plan required, activating is easy, just 3 steps.
  • DISPLAY: Immersive viewing on a 6.7-inch super-bright 120Hz display with powerful stereo speakers and Bass Boost for cinematic entertainment.
  • CAMERA SYSTEM: Advanced 50MP Quad Pixel camera captures sharp, detailed photos and videos in any lighting condition
  • PERFORMANCE: Lightning-fast 5G connectivity paired with a powerful processor and RAM Boost for smooth multitasking.
  • BATTERY LIFE: Long-lasting 5000mAh battery with TurboPower charging technology delivers hours of power in minutes.
  1. Create a page with browser.newPage().
  2. Choose either page.emulate(KnownDevices['Pixel 7']) or page.setViewport({...}).
  3. Navigate to the target and choose a wait condition appropriate to the page.
  4. Call page.screenshot() after the page reaches the state you need.

Choose what the screenshot includes

A standard page.screenshot() captures the viewport. To capture the complete document instead, set fullPage: true:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
await page.screenshot({ path: 'full-page.png', fullPage: true });

Use the viewport capture for a screenshot at the selected screen dimensions. Use full-page capture when the goal is a tall image of the whole document; it is not limited to what fits on screen.

Rank #3
Samsung Galaxy A17 5G Smart Phone 128GB, US 1 Yr Manufacturer Warranty Blue | Large AMOLED, High-Res Camera, Durable Design, Super Fast Charging, Expandable Storage, Circle to Search, 2025
  • YOUR CONTENT, SUPER SMOOTH: The ultra-clear 6.7" FHD+ Super AMOLED display of Galaxy A17 5G helps bring your content to life, whether you're scrolling through recipes or video chatting with loved ones.¹
  • LIVE FAST. CHARGE FASTER: Focus more on the moment and less on your battery percentage with Galaxy A17 5G. Super Fast Charging powers up your battery so you can get back to life sooner.²
  • MEMORIES MADE PICTURE PERFECT: Capture every angle in stunning clarity, from wide family photos to close-ups of friends, with the triple-lens camera on Galaxy A17 5G.
  • NEED MORE STORAGE? WE HAVE YOU COVERED: With an improved 2TB of expandable storage, Galaxy A17 5G makes it easy to keep cherished photos, videos and important files readily accessible whenever you need them.³
  • BUILT TO LAST: With an improved IP54 rating, Galaxy A17 5G is even more durable than before.⁴ It’s built to resist splashes and dust and comes with a stronger yet slimmer Gorilla Glass Victus front and Glass Fiber Reinforced Polymer back.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

ScreenshotNeo accepts a URL in one GET request and returns an image or PDF. For example, this cURL request saves a WebP screenshot; replace the URL with your target. See the ScreenshotNeo API documentation for request options.

Best Value
Tracfone Moto g Play 2024 Prepaid Phone with a 1-Yr Plan Included | Prepaid Smartphone with Full YR Plan Included bundled with 1500 Min/Text/Data for365 days of service - Locked to Tracfone
  • Carrier: This phone is locked to Tracfone, which means this device can only be used on the Tracfone wireless network. Activating is easy, just 3 steps.
  • ACTIVATION Promotion: Includes 1500 min, 1500 texts & 1500 MB Data + add more as you need it
  • CAMERA SYSTEM: 50MP Quad Pixel camera. Capture sharper, more vibrant photos day or night with 4x the light sensitivity.
  • PERFORMANCE: Blazing-fast Qualcomm performance. Get the speed you need for great entertainment with a Snapdragon 680 processor and 4GB of RAM.
  • 64GB built-in storage. Get plenty of room for photos, movies, songs, and apps. Made for US
Rank #4
Sale
Samsung Galaxy S26 Ultra, Unlocked Android Smartphone, 512GB, Black | Privacy Display, Galaxy AI, AI Camera, Super Fast Charging 3.0, Durable Battery, 2026, US 1 Year Warranty
  • PRIVACY DISPLAY: Automatically hide your screen from those beside you. The built-in privacy display can be preset¹ to turn on when receiving notifications, typing passwords, or using specific apps
  • TYPE IT IN. TRANSFORM IT FAST: Enhance any shot in seconds on your smartphone by using Photo Assist² with Galaxy AI.³ Add objects, restore details, or apply new styles by simply typing or tapping
  • NIGHTS, CAPTURED CLEARLY: From gigs to city lights, record and capture moments after dark with clarity using Nightography so your photos and videos stay crisp and clear on your Samsung Galaxy
  • MAKE IT. EDIT IT. SHARE IT: Turn everyday moments into something personal with creative tools built right into your mobile phone, whether it’s a special contact photo, custom wallpaper, an invitation or more⁴
  • HELP THAT KEEPS UP: Stay in the moment while Now Nudge with Galaxy AI helps you respond faster and stay organized with smart suggestions⁵ that appear exactly when you need them on your phone
curl -G "https://api.screenshotneo.com/v1/shot" -d access_key=YOUR_API_KEY --data-urlencode url=https://example.com -o shot.webp

ScreenshotNeo removes supported cookie and consent banners, newsletter popups, and chat widgets before capture. Bot checks, blank pages, failed loads, timeouts, and cache hits are not billed; response headers identify the page verdict and billing status. Its MCP server provides screenshot tools for AI agents, and the free plan includes 1,000 screenshots per month without a card; paid plans start at $5 for 3,000 shots. Learn about ScreenshotNeo or sign up free for 1,000 screenshots a month, with no card.

Troubleshooting

  • The page looks like desktop. Confirm the profile or viewport is applied before navigation. A width and height alone are not equivalent to a named profile’s metrics and user agent; if the site depends on mobile-specific behavior, use page.emulate() or configure the relevant mobile and touch properties explicitly.
  • The dimensions do not match a particular phone. The example viewport values are illustrative, not a general Android specification. Choose a named profile or use the exact CSS viewport dimensions required by your target.
  • The screenshot is only the visible screen. That is the default extent. Set fullPage: true when you want the full document.
  • The page is incomplete when captured. The example waits for networkidle2, but page behavior varies. Select a wait condition that reflects the state you need; the screenshot should run after required content has loaded.
  • The capture differs from a real Android phone. Puppeteer’s device emulation applies metrics and user-agent settings; it is not physical-device validation. Check the result separately on the hardware you need to support.

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
Outdated Drivers Are Slowing You DownFree scan - exact matches
Windows Errors? Fix Them Before They SpreadFree repair scan

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.