Timeouts

Timeouts for XCUI test cases(which are in the running state) on BrowserStack may happen for 2 reasons:

1. Idle Timeout: The test case was idle for 15 mins. It means that the app did not receive any new command from the test.
2. Session limit reached: The session got timed out (by BrowserStack) because it exceeded the maximum allowed 2 hour limit.
   

Idle timeout

In order to prevent tests from running too long in case something has gone wrong, BrowserStack limits how long a test can remain idle or how long can the app wait for a test to send a new command. This is set to 900 seconds by default. However, you can adjust this limit as per your requirement. The value of this setting is in seconds.

In order to specify the custom idle timeout value, you need to pass the idleTimeout parameter in the REST API request to start XCUITest test execution.

REST API endpoint:

 POST /app-automate/xcuitest/v2/build

Example cURL request :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"idleTimeout": 180, "devices": ["iPhone 8 Plus-11.0"], "app": "bs://f5L3azt9pLzE995f49376eb1fa3c284dc321f8d", "testSuite": "bs://6eb1fa3c284ddbe9971b2d1aee0d52943b9c081"}' \
-H "Content-Type: application/json"

Session limit reached

The maximum duration for which the session execution is allowed on BrowserStack is 2 hours. If this time limit is exceeded, the session execution will be stopped, changing the session status to TIMED OUT on the dashboard.

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.