Skip to content

iPhone Duo Automation

The XCUITest driver supports automation of the iPhone Duo simulator.

Duo sessions have the following minimum requirements:

  • XCUITest driver 12.17.0 or later (WebDriverAgent 16.14.2 or later)
  • Xcode 27.1 or later

Duo sessions use the standard iOS simulator setup with platformName: iOS.

Session Actions

Duo apps are automated the same way as regular iOS/iPadOS apps - the standard findElement/click methods and other native element interactions work as usual.

Available displays can be listed with mobile: listDisplays. Use the currentDisplayId setting to select the display for screenshots, W3C actions, WDA MJPEG, and new XCTest recordings. Folding does not update this setting: select the inner display when opening Duo and the outer display when closing it. Restart XCTest recording to change its display.

The simulated hinge angle can be read and changed through the mobile: getSimulatedHingeAngle and mobile: setSimulatedHingeAngle extensions.

Known Limitations

  • Duo automation has been verified only on the simulator. Feedback from real-device testing is welcome.