Device Emulation

What is device emulation?

Device emulation sets the browser's viewport, pixel density (device scale factor), and touch capabilities to match a specific device. This allows accurate mobile and tablet rendering without needing a physical device.

Using a preset device

Set the device_name parameter to a preset device name. Preset devices automatically configure width, height, scale factor, and mobile/touch settings:

{
  "url": "https://example.com",
  "device_name": "iPhone 13"
}

When a device name is selected, the screen width, height, and scale fields are locked to the device's specs.

Custom device settings

For a custom device configuration, leave device_name empty and set individual parameters:

• device_scale — device pixel ratio (e.g. 2 for Retina).
• device_mobile — flag the device as mobile.
• device_touch — enable touch event emulation.
• device_landscape — render in landscape orientation.

{
  "url": "https://example.com",
  "screen_width": 390,
  "screen_height": 844,
  "device_scale": 3,
  "device_mobile": true,
  "device_touch": true
}