Use page.setViewport() and pass the viewport width and height in CSS pixels. Set it before page.goto() so the page’s first load uses the dimensions you want to test.
Set a custom mobile-sized viewport
This example uses 390 × 844 CSS pixels as an illustrative test size, not a universal phone standard. isMobile and hasTouch are optional: include them when the page behavior you are testing depends on mobile viewport handling or touch support.
As an Amazon Associate I earn from qualifying purchases.
const puppeteer = require('puppeteer');
(async () => {
const browser = await puppeteer.launch();
try {
const page = await browser.newPage();
await page.setViewport({
width: 390,
height: 844,
deviceScaleFactor: 1,
isMobile: true,
hasTouch: true,
});
await page.goto('https://example.com');
// Run assertions or capture a screenshot here.
} finally {
await browser.close();
}
})();The official Puppeteer Page.setViewport() documentation recommends setting the viewport before navigating. Changing it after navigation can produce behavior the site does not expect, and setting isMobile or hasTouch can reload the page in some cases.
Choose the settings that match your test
The viewport API takes an object. The dimensions are in CSS pixels; they are not physical screen pixels.
#1 Best Overall
- Universal unlocked. Compatible with all major U.S. carriers, including Verizon, AT&T, T-Mobile and other prepaid carriers.
- Super-bright, super-smooth 6.7" display. See your screen clearly even outdoors in sunlight, and enjoy seamless views with a fast-refreshing 120Hz display.*
- AI-powered camera system. Take stunning photos in any light with the 50MP camera**, look your best with a 32MP selfie cam*****, and capture extreme close-ups.
- Superfast 5G performance. Unleash your entertainment at 5G speed*** with the MediaTek Dimensity 6300 chipset and up to 12GB of RAM with RAM Boost****.
- Long-lasting battery + TurboPower charging. Power through day after day with a 5200mAh battery, then get hours of power in just minutes.****
| Option | What it controls | When to set it |
|---|---|---|
width, height |
Viewport dimensions in CSS pixels. | Set the layout size or responsive breakpoint you need to test. |
deviceScaleFactor |
The emulated device scale factor. | Set it when your test needs to account for a particular rendering scale. |
isMobile |
Whether the page’s meta viewport tag is taken into account. | Enable it if the behavior under test depends on mobile viewport handling. |
hasTouch |
Whether the viewport supports touch events. | Enable it when testing touch-dependent interactions. |
isLandscape |
Whether the emulated viewport is landscape. | Set it when orientation is part of the test. |
For a breakpoint check, dimensions alone may be enough. Mobile flags describe additional emulated behavior; they are not mandatory for every responsive-layout test. Puppeteer documents these settings in its Viewport interface.
Emulate a named device instead
Use page.emulate() when the test calls for a Puppeteer device profile rather than just a chosen layout size. For example, Puppeteer documents selecting a profile from KnownDevices:
Rank #2
- 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.
const puppeteer = require('puppeteer');
const { KnownDevices } = require('puppeteer');
(async () => {
const browser = await puppeteer.launch();
try {
const page = await browser.newPage();
const device = KnownDevices['iPhone 17 Pro'];
await page.emulate(device);
await page.goto('https://example.com');
} finally {
await browser.close();
}
})();page.emulate() applies the selected device’s metrics and user agent. Puppeteer documents it as a shortcut for setting the user agent and viewport together. Choose this when those profile settings matter; use setViewport() when you need direct control over dimensions and selected flags. See the official Page.emulate() documentation for the device-profile method.
Quick wins for a faster PC:
Clear out junk files and repair common Windows errorsFree Scan →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Check or reset the viewport
Each page in a browser can have its own viewport. page.viewport() reports the viewport settings last set on that page, or the default viewport from the browser connection options; it does not verify the actual viewport.
Rank #3
- Charger NOT Included, 6.7" Super AMOLED FHD+, 90Hz Refresh Rate, 385 ppi, 800 nits (HBM), 1080x2340px, 5000mAh Battery
- 128GB, 4GB RAM, microSDXC, Exynos 1330 (5nm), Octa-Core, Mali-G68 MP2 or Mali-G57 MC2 GPU
- Rear Camera: 50MP, f/1.8 (wide) + 5MP, f/2.2 (ultrawide) + 2MP, f/2.4 (macro), LED flash, panorama, HDR; Front Camera: 13MP, f/2.0, Android 14, up to 6 major Android upgrades, One UI 6.1
- 3G: HSDPA 850/900/1700(AWS)/1900/2100; 4G LTE: 1/2/3/4/5/7/12/13/14/20/25/26/28/29/30/38/39/40/41/48/66/71, 5G: 2/5/25/41/66/71/77/78 SA/NSA/Sub6/mmWave - Nano-SIM + eSIM
- US Model – Global Connectivity – Compatible with Most GSM Carriers like T-Mobile, AT&T, MetroPCS, etc. Will Also work with CDMA Carriers Such as Verizon, Straight Talk.
console.log(page.viewport());
// Restore Puppeteer's default viewport for this page:
await page.setViewport(null);What viewport emulation does—and does not—mean
Setting dimensions tests a page at a CSS-pixel viewport size. Adding mobile flags or selecting a named device profile changes other emulated settings, but viewport configuration alone does not reproduce every aspect of a physical phone. Make the configuration explicit in your test so the result is reproducible.
Troubleshooting viewport tests
- The layout does not match the expected mobile breakpoint: Confirm the intended width is passed in CSS pixels, and set the viewport before navigation. If the page depends on its meta viewport tag, test with
isMobile: true. - Touch interactions are missing: Set
hasTouch: truewhen touch-event support is part of the scenario. A mobile-sized viewport by itself does not enable that flag. - The page changes or reloads after setting mobile options: Apply viewport settings before
goto(). Puppeteer notes that changing properties such asisMobileorhasTouchmay reload the page in some cases. page.viewport()shows a size, but you need to verify rendered behavior: That method returns configured viewport settings, not a measurement of the browser’s actual viewport. Check the page behavior your test cares about rather than treating the getter as an actual-rendering probe.- You need a known device configuration, not just dimensions: Use a profile from
KnownDeviceswithpage.emulate(), which also applies a user agent.
Or skip the browser setup
ScreenshotNeo can return a website screenshot through one API request. For a WebP capture of a page:
Quick Recap
Best Value
- 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.
Rank #4
- 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.
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 request options. ScreenshotNeo removes cookie banners, newsletter popups and chat widgets before capture; bot checks, blank pages and failed loads are never billed. Its MCP server lets AI agents take screenshots, and the Free plan includes 1,000 screenshots a month with no card; paid plans start at $5 for 3,000.
Sign up for ScreenshotNeo’s free plan.
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.
