playwright-php/devices

Playwright device descriptors in PHP (mobile & desktop screens, user agents, viewports, scale factors, touch/mobile flags).

v1.0.0 2025-11-08 13:33 UTC

Requires

• php: ^8.2

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.40
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^12.3

MIT

• Simon André
• Playwright PHP Contributors

• mobile
• user-agent
• desktop
• tablet
• emulation
• Devices
• browsers
• viewport
• playwright
• descriptors

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

Device	Browser	Screen	Scale	Viewport	Landscape	Mobile	Touch
Desktop Chrome	Chromium	1920 x 1080	1	1280 x 720		No	No
Desktop Chrome HiDPI	Chromium	1792 x 1120	2	1280 x 720		No	No
Desktop Edge	Chromium	1920 x 1080	1	1280 x 720		No	No
Desktop Edge HiDPI	Chromium	1792 x 1120	2	1280 x 720		No	No
Desktop Firefox	Firefox	1920 x 1080	1	1280 x 720		No	No
Desktop Firefox HiDPI	Firefox	1792 x 1120	2	1280 x 720		No	No
Desktop Safari	Webkit	1792 x 1120	2	1280 x 720		No	No
Blackberry PlayBook	Webkit	n/a	1	600 x 1024	1024 x 600	Yes	Yes
BlackBerry Z30	Webkit	n/a	2	360 x 640	640 x 360	Yes	Yes
Galaxy A55	Chromium	n/a	2.25	480 x 1040	1040 x 480	Yes	Yes

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.