Specify devices using regular expressions
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:
| Parameter | Description | Sample values |
|---|---|---|
devices |
Required - device is required. - os_version is optional. The latest OS version is allocated for the device model if you do not pass this key. |
"devices": [{ "device": "iPhone.*", "os_version": "1[56]"}] This allocates any iPhone device with OS version 15 or 16. |
Use the device selector below to select an iOS device of your choice:
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 the using regular expression to specify device attributes:
| Use case | Number of parallels consumed | Parameter structure |
|---|---|---|
| Run test suite on any iPhone 14 models with OS version 16 | 1 | "devices": [{"device": "iPhone 14.*", "os_version": "16.0"}] |
| Run test suite on any 2 iPhone 14 models with OS version 16 | 2 | "devices": [{"device": "iPhone 14.*", "os_version": "16.0"}, {"device": "iPhone 14.*", "os_version": "16.0"}] |
| Run test suite on any 1 iPhone 14 model with OS version 16 and any 2 iOS devices with OS version 15 or 16 | 3 | "devices": [{"device": "iPhone 14.*", "os_version": "16.0"}, {"device": ".*", "os_version": "1[56]"}, {"device": ".*", "os_version": "1[56]"}] |
Once you start the Flutter test execution, you can access the test execution results on the App Automate dashboard.
Related topics
-
Manage your uploaded test package using our REST API.
-
Delete your uploaded test package using the delete test package API endpoint.
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
We're sorry to hear that. Please share your feedback so we can do better
Contact our Support team for immediate help while we work on improving our docs.
We're continuously improving our docs. We'd love to know what you liked
Thank you for your valuable feedback!