Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsSlow PC?RecommendedPC slow today? Run a repair scan before it gets worseResolve common Windows issues and optimize system performance.Scan Now×
Skip to content
World desk3 min

How to Use Puppeteer’s Known Devices for Emulation

Select an exact KnownDevices profile, apply it with page.emulate() before navigating, and understand the user-agent and viewport settings it covers.

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.

Import KnownDevices from puppeteer, select a profile by its exact documented key, and call page.emulate(profile) before navigating. For example, use KnownDevices['iPhone 17 Pro'] to apply that profile’s user agent and viewport to a Puppeteer page.

Use a named device profile before navigation

This example follows Puppeteer’s documented sequence. Replace the target URL with the page you want to check.

As an Amazon Associate I earn from qualifying purchases.

import puppeteer, {KnownDevices} from 'puppeteer';

const device = KnownDevices['iPhone 17 Pro'];
const browser = await puppeteer.launch();
const page = await browser.newPage();

await page.emulate(device);
await page.goto('https://example.com');

// Run checks here.
await browser.close();
  1. Import KnownDevices from the Puppeteer package used by your project.
  2. Choose a profile using its exact string key, such as KnownDevices['iPhone 17 Pro'].
  3. Launch the browser and create a page.
  4. Call and await page.emulate(device).
  5. Navigate with page.goto(), then run your checks.

Call emulation before navigation. Puppeteer says the method resizes the page and recommends setting the profile first because many sites do not expect phones to change size. See the Page.emulate() reference.

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

What KnownDevices and page.emulate() configure

KnownDevices is a readonly record of named device profiles. The Device interface has userAgent and viewport properties. Puppeteer describes page.emulate(device) as a shortcut for calling Page.setUserAgent() and Page.setViewport(); it applies the profile’s user agent and metrics to the page.

#1 Best Overall
Detectors Inductance Tester Motherboards Coils Tester for Quick Fault Detection, High Sensitivity Electromagnetic Induction Quick Fault Check Tool for Detection
  • Rapid Fault Detection Instantly identifies malfunctioning circuits with clear LED indicators, ensuring quick diagnosis and saving valuable troubleshooting time for technicians
  • Universal Smartphone Compatibility Works seamlessly with various smartphone models without needing adapters, streamlining workflow for multibrand repair professionals and enhancing convenience
  • Portable And Lightweight Design Its compact and lightweight body ensures effortless portability during on site repairs or workshop maintenance, ideal for electronics technicians and field service engineers
  • Optimized For Time Critical Troubleshooting Combines electromagnetic precision with rapid chip powered response for instant component analysis, perfect for mobile repair stations and urgent diagnostic tasks
  • Complete Package Includes 1pc Circuit Tester ready for immediate use, providing a reliable and efficient tool for all your electrical testing needs

This is browser-side profile emulation, not a promise that a desktop browser becomes identical to a physical phone or tablet. The API references document the user agent and viewport, but do not claim complete hardware or operating-system simulation. If a result depends on real hardware, OS behavior, or a browser behavior the profile does not represent, verify it separately on that environment.

Choose and verify the profile key

The API reference includes portrait and landscape profile names. Examples include iPhone 17 Pro, iPhone 17 Pro landscape, iPad, iPad landscape, Galaxy S9+, and Pixel 5. These are examples, not a guarantee that every key is present in every installed release.

Rank #2
BACtrack C6 Keychain Breathalyzer | BAC Alcohol Tester | Optional App
  • ESTIMATE YOUR ALCOHOL LEVEL WITH PRO-GRADE ACCURACY - Powered by BACtrack's patented BluFire Fuel Cell Sensor, the C6 utilizes the same professional-grade technology trusted by hospitals, clinics, and even law enforcement.
  • KNOW WHEN YOUR BAC WILL RETURN TO 0.00% - BACtrack's innovative ZeroLine technology estimates the time until your blood alcohol content is 0.00%, allowing you to quickly and easily know where you stand.
  • SMALL & PORTABLE DESIGN - This mini handheld breathalyzer measures fits easily in a purse, pocket, or on your keychain, so you can always have it when you need it.
  • OPTIONAL WIRELESS CONNECTIVITY - Use the BACtrack C6 with or without your smartphone. "Standalone Mode" delivers your BAC results directly to your C6. "App Mode" wirelessly delivers your BAC results to the BACtrack App on your smartphone. Easily switch between modes.
  • ONE-YEAR WARRANTY - If your BACtrack ceases to function properly during the first year of operation, we will repair or replace the defective device.
  • Use the exact spelling and punctuation of a key; portrait and landscape variants are separate entries where listed.
  • Check the KnownDevices API reference and the type definitions in your installed Puppeteer package for the keys available to your version.
  • When comparing profiles, inspect the particular key and its viewport and user-agent values that matter to the page under test.

The official KnownDevices reference displayed version 25.11.0 when accessed October 3, 2026. The Page.emulate() reference displayed version 25.12.0 on that date; these are documentation version labels, not publication dates. The Device interface reference displayed version 25.11.0. Check the current references and your installed package rather than assuming the displayed list or version is unchanged.

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

Troubleshoot common issues

The selected profile is undefined

A misspelled key, a key absent from your installed Puppeteer release, or a portrait/landscape name mismatch can leave the selection without a usable profile. Compare the string with the API reference and your installed package’s types, then use an exact available key.

Rank #3
TelPal Landline Test Phone Line Set Telecom Check Telephone Line Dedicated Check Line Survey Line Machine Tester to Alligator Clip Set Equipment
  • It is smart and lightweight,computer lab preferred.
  • FSK/DTMF caller id identification automatically.
  • Real time, date and week display.
  • Flash and Redial function.
  • In use led indicator function.

The page appears at the wrong size

Confirm that you awaited page.emulate(device) and called it before page.goto(). Also check that you selected the intended orientation: a landscape profile has different viewport dimensions from its portrait counterpart.

The site still behaves differently from a real device

The documented profile configures user-agent and viewport behavior; it does not establish that every physical-device, operating-system, or hardware behavior is reproduced. Reproduce device-dependent issues in the relevant real environment.

Rank #4
Accu-Chek Guide Me Glucose Monitor Kit for Diabetic Blood Sugar Testing
  • This blood sugar monitoring kit is designed to help you easily manage your diabetes and have better control of your health; Includes: Guide Me meter (batteries included), Softclix lancing device, and 10 lancets
  • The Guide Me meter is Bluetooth enabled to sync with a smartphone and automatically log test results using the mySugr app; Features a large, easy-to-read LCD display and stores 720 test results plus 30 control records
  • Child-resistant battery door helps prevent a child from accessing the batteries; To open the door, insert a narrow object, such as a pen, into the door slot pushing the tab inward while lifting up the door
  • With 11 customizable depth settings, the Softclix lancing device makes it easier to get the right amount of blood the first time
  • Easy-to-use, sterile Accu-Chek lancets are thin-gauge and bevel-cut to help ensure smoother entry; Engineered to reduce pain
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or skip the browser setup

If your goal is to get a screenshot of a page rather than test a Puppeteer device profile, ScreenshotNeo is a screenshot API and MCP server. A single GET request can return a PNG, JPEG, WebP, or PDF. This does not replace Puppeteer’s profile emulation when you need to test responsive behavior.

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

For a screenshot, use cURL:

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

See the ScreenshotNeo documentation for API options. 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 server gives AI agents tools to take screenshots, get page information, and capture PDFs. 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 to get 1,000 screenshots a month with no card.

Best Value
Sale
BACtrack C8 Breathalyzer | BAC Alcohol Tester | Optional App
  • ESTIMATE YOUR ALCOHOL LEVEL WITH PRO-GRADE ACCURACY - Powered by BACtrack's patented BluFire Fuel Cell Sensor, the C8 utilizes the same professional-grade technology trusted by hospitals, clinics, and even law enforcement
  • KNOW WHEN YOUR BAC WILL RETURN TO 0.00% - BACtrack's innovative ZeroLine technology estimates the time until your blood alcohol content is 0.00%, allowing you to quickly and easily know where you stand
  • SMALL & PORTABLE DESIGN - This mini handheld breathalyzer fits easily in a purse, pocket, or car, so you can always have it when you need it
  • OPTIONAL WIRELESS CONNECTIVITY - Use the BACtrack C8 with or without your smartphone. "Standalone Mode" delivers your BAC results directly to your C8. "App Mode" wirelessly delivers your BAC results to the BACtrack App on your smartphone. Easily switch between modes
  • ONE-YEAR WARRANTY - If your BACtrack ceases to function properly during the first year of operation, we will repair or replace the defective device

Frequently Asked Questions

Does Puppeteer’s device emulation test a site on a physical iPhone or tablet?

No. It applies the profile’s documented user-agent and viewport settings; it does not guarantee physical hardware or operating-system simulation.

Do I need to set the profile again for each new page?

The example applies the profile to the specific Page object. Apply emulation to each page you intend to use with that profile.

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

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.

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.