iOS device setup

8 min readLast updated 2026-04-27Beta

Configure iOS real device testing with WebKit and Safari automation.

iOS testing uses WebKit via Playwright or Appium with Safari. Real devices require a cloud device farm or a macOS CI runner with Xcode.

Playwright WebKit (simulator)

{
  name: 'iOS Safari',
  use: {
    browserName: 'webkit',
    viewport: { width: 390, height: 844 },
    userAgent: '...iPhone...',
  },
}

typescript

{
  platformName: 'iOS',
  platformVersion: '17.0',
  deviceName: 'iPhone 15',
  automationName: 'XCUITest',
}

javascript

Beta limitation

iOS real device testing requires a cloud provider or self-hosted macOS runner. Linux runners cannot automate iOS devices.

Was this article helpful?

Mobile testing overview

5 min read

Android device setup

8 min read

Cloud device farm integration

6 min read

Our support team is here to help. Reach out directly or search the docs.