Skip to main content

Simulate device modes and network conditions

BrowserStack App Automate allows you to test mobile apps under different network conditions, including offline mode, airplane mode, and network profiles like 3G-UMTS-Good, 4G-LTE-Good, and more, on BrowserStack’s actual mobile device cloud.

To simulate network conditions, choose from our predefined network profiles or create a custom network profile. You need to set the networkProfile or customNetwork parameter in the builds REST API when starting your Flutter integration test.

REST API endpoint:

POST /app-automate/flutter-integration-tests/v2/builds

Simulate device modes and network conditions using pre-defined profiles

The networkProfile parameter enables you to simulate a device mode and specific network conditions.

To simulate the offline or airplane mode on a device, set networkProfile to no-network or airplane-mode:

Profile Name Description
no-network Disables network settings to set the device offline.
airplane-mode Turns on the Airplane mode setting on the device.

Example cURL request to simulate the device offline mode:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/android/build" \
-d '{"networkProfile": "no-network", "devices": ["Samsung Galaxy S8-7.0"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"

To simulate a specific network condition, set networkProfile to the relevant profile name from the table given here. For example, if you want to simulate a condition in which bandwidth in/out is 50/30 kbps, latency is 500 ms, and packet loss is 1%, set networkProfile to 2g-gprs-good.

Profile Name Bandwidth in/out (Kbps) Latency (ms) Packet Loss (%)
2g-gprs-good 50/30 500 1
2g-gprs-lossy 30/20 650 2
edge-good 250/150 300 0
edge-lossy 150/100 500 1
3g-umts-good 400/100 100 0
3g-umts-lossy 200/50 200 1
3.5g-hspa-good 1800/400 100 0
3.5g-hspa-lossy 900/200 190 1
3.5g-hspa-plus-good 7000/1500 100 0
3.5g-hspa-plus-lossy 2000/600 130 1
4g-lte-good 18000/9000 100 0
4g-lte-high-latency 18000/9000 3000 0
4g-lte-lossy 7000/3000 120 1
4g-lte-advanced-good 25000/18000 80 0
4g-lte-advanced-lossy 15000/10000 70 1
reset Set network settings to BrowserStack’s default configuration    

Example cURL request to simulate network conditions using pre-defined network profiles:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/android/build" \
-d '{"networkProfile": "3g-umts-good", "devices": ["Samsung Galaxy S8-7.0"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"

Simulate network conditions using a custom network profile

To simulate a custom network condition, specify the download speed, the upload speed, latency, and packet loss, in that order, as values for the customNetwork parameter. For details, see the following table:

Profile Description
Download speed (kbps) Indicates the rate at which the device can retrieve data from the network, with higher values indicating faster download speeds, simulating quicker connections.
Upload speed (kbps) Represents the rate at which the device can send data from the device to the network, allowing for the adjustment of various upload speed scenarios.
Latency (ms) Measures the delay between the device sending a request and receiving a response, with higher latency values simulating delays similar to real-world conditions.
Packet loss (%) Allows for the simulation of data packet loss within the network, mimicking real-world scenarios. Adjusting this percentage assesses performance under adverse conditions.

By configuring these parameters within your custom network profile, you can precisely emulate diverse network environments, facilitating effective testing and optimization of your applications and services under different conditions. This level of control ensures that your product remains robust and reliable, regardless of the network challenges it may encounter in the real world.

Example cURL request to simulate custom network condition:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/flutter-integration-tests/v2/builds" \
-d '{"customNetwork": "1000, 1000, 100, 1", "devices": ["Samsung Galaxy S8-7.0"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"

Network profile and custom network features for app testing are exclusively available with a paid BrowserStack plan. You can view more details on pricing here.

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

Is this page helping you?

Yes
No

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!

Talk to an Expert
Download Copy