Specify devices

You can run your XCUI automation tests on a wide range of iOS devices on BrowserStack. These are not simulators or emulators but physical devices hosted in our data centers. You can specify the device attributes either with or without using a regular expression (regex).

Specify device attributes

While executing your XCUI tests, you can specify a list of iOS devices to run your tests on. In order to do so, you need to pass the devices parameter in the REST API request to start your test execution. You can set its value as shown in the table below.

REST API endpoint :

POST /app-automate/xcuitest/v2/build

You can easily execute your XCUI tests on multiple devices as shown in an example cURL request below :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"devices": ["iPhone X-11", "iPhone 8-11", "iPhone XS-12"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"

Use regular expressions to specify device attributes

You can use regular expressions (regex) to select devices to test on instead of providing specific device models in the devices parameter using the builds REST API. Based on the regex you pass, the first available device is allocated from the device pool that matches your specifications. By widening your search through regular expressions, you get better test execution speed by reducing queuing and device tier limits.

The following table provides information on how to use regular expressions for specifying device attributes:

Example cURL request where a regular expression has been used to specify tests to run on any 2 iPhone devices with OS version 15 or 16:

Here are some use cases of using regular expressions to specify device attributes:

Related topics

• Manage your uploaded app or test suite using our upload app REST API and upload test suite REST API.

• Use the get app API endpoint and list test suites API endpoint to list your recently uploaded apps and test suites.

• Delete your uploaded app or test suite using the delete app API endpoint and delete test suite API endpoint.