Simulate network conditions

BrowserStack App Automate enables you to test mobile apps under various network conditions such as offline mode, airplane mode, and network profiles such as 3g-umts-good, 4g-lte-good, etc on BrowserStack’s real mobile device cloud.

To simulate network conditions, you can use any of our pre-defined network profiles or create a custom one. In this guide, you will learn how to:

1. Simulate device offline and airplane mode
2. Simulate network conditions using pre-defined network profiles
3. Simulate network conditions using a custom network profile

Simulate device offline and airplane mode

To simulate device offline or airplane mode, use the following network profiles :

Use the following REST API endpoint with appropriate networkProfile parameter value :

POST /app-automate/xcuitest/v2/build

Example:

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

Simulate network conditions using pre-defined network profiles

To simulate various network conditions such as 3G, 4G, etc, use any of the following pre-defined network profiles :

Use the following REST API endpoint with appropriate networkProfile parameter value :

POST /app-automate/xcuitest/v2/build

Example:

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

Simulate network conditions using a custom network profile

To simulate a custom network condition, create a custom network profile using the following parameters :

• Download speed (kbps)
• Upload speed (kbps)
• Latency (ms)
• Packet loss (%)

Use the following REST API endpoint with appropriate customNetwork parameter value :

POST /app-automate/espresso/v2/build

Example :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"customNetwork": "1000, 1000, 100, 1", "devices": ["iPhone 8 Plus-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.

  Need some help?

If you have any queries, please get in touch with us.