Filter Test Cases
By default, all the test cases from an XCUI test-suite are executed. However, you can specify selected classes or tests to be executed in any build. These options can be useful in multiple scenarios :
- Run a quick smoke test to ensure the sanity of important functionality.
- Run only those test cases that are relevant to a new bug fix.
- Split a large test-suite into multiple shards and run them in parallel.
In order to do so, you need to pass relevant parameters in the API request to start the XCUI test execution. These parameters are outlined in the table below.
REST API endpoint :
POST /app-automate/xcuitest/v2/build
Parameter | Description | Values |
---|---|---|
only-testing |
Specify the selected classes or tests to be executed in the build | A list of fully qualified class/test name Example: ["SampleXCUITestsClass/testAlertTest"]
|
skip-testing |
Skip particular classes or tests from testing in the build | A list of fully qualified class/test name Example: ["SampleXCUITestsClass/testAlertTest"]
|
Example cURL
requests :
Execute particular test cases(from your test-suite) belonging to any class or execute all test cases of a class :
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"only-testing": ["SampleXCUITestsClass/testAlert", "SampleXCUITestsClass/testText"], "devices": ["iPhone 8 Plus-11.0"], "app": "bs://f5L3azt9pLzE995f49376eb1fa3c284dc321f8d", "testSuite": "bs://6eb1fa3c284ddbe9971b2d1aee0d52943b9c081"}' \
-H "Content-Type: application/json"
You can skip certain specific test cases(from your test-suite) belonging to any class or skip all the test cases of a class:
curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"skip-testing": ["SampleXCUITestsClass/testAlert"], "devices": ["iPhone 8-11.0"], "app": "bs://f5L3azt9pLzE995f49376eb1fa3c284dc321f8d", "testSuite": "bs://6eb1fa3c284ddbe9971b2d1aee0d52943b9c081"}' \
-H "Content-Type: application/json"
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.
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!