README

Playwright PHP: Device Descriptors

This package provides the official device descriptors from Microsoft Playwright for use with Playwright PHP.

Installation

composer require playwright-php/devices

Usage

Device Registry

use Playwright\Device\DeviceRegistry;

$device = (new DeviceRegistry())->get('iPhone 15 Pro');

Device descriptor

The returned $device is an instance of Playwright\Device\Device, with the following methods:

$device->getName();               // 'iPhone 15 Pro'
$device->getUserAgent();          // 'Mozilla/5.0 (iPhone; CPU [...]'
$device->getViewport();           // ['width' => 393, 'height' => 659]
$device->getScreen();             // ['width' => 393, 'height' => 852]
$device->getDeviceScaleFactor();  // 3
$iphone->isMobile();              // true
$iphone->hasTouch();              // true
$iphone->getDefaultBrowserType(); // 'webkit'

Browser emulation

// Pass the device properties to a new browser context:
$browser->newContext([
    'userAgent' => $iphone->getUserAgent(),
    'viewport' => $iphone->getViewport(),
    'isMobile' => $iphone->isMobile(),
    'hasTouch' => $iphone->hasTouch(),
]);

// Or more simply:
$browser->newContext($iphone->toArray());

Catalog

Explore the full list of devices in docs/DEVICES.md.

License

This package is released by the Playwright PHP project under the MIT License. See the LICENSE file for details.