Simulate mobile 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 :

Examples:

To apply the network profile at the start of the session, use :

DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("browserstack.networkProfile", "no-network");

var capabilities = {
	'browserstack.networkProfile': 'no-network'
}

DesiredCapabilities capability = new DesiredCapabilities();
capability.SetCapability("browserstack.networkProfile", "no-network");

$capabilities = new DesiredCapabilities();
$capabilities->setCapability("browserstack.networkProfile", "no-network");

desired_cap = {
	'browserstack.networkProfile': 'no-network'
}

desired_caps = {
    'browserstack.networkProfile': 'no-network'
}

To apply the network profile in the middle of the session, use :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" -H "Content-Type: application/json" -d '{"networkProfile":"no-network"}' -X PUT "https://api-cloud.browserstack.com/app-automate/sessions/<sessionid>/update_network.json"

Note: Use driver.session_id command to get the session id.

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 :

Examples:

To apply the network profile at the start of the session, use :

DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("browserstack.networkProfile", "2g-gprs-good");

var capabilities = {
	'browserstack.networkProfile': '2g-gprs-good'
}

DesiredCapabilities capability = new DesiredCapabilities();
capability.SetCapability("browserstack.networkProfile", "2g-gprs-good");

$capabilities = new DesiredCapabilities();
$capabilities->setCapability("browserstack.networkProfile", "2g-gprs-good");

desired_cap = {
	'browserstack.networkProfile': '2g-gprs-good'
}

desired_caps = {
    'browserstack.networkProfile': '2g-gprs-good'
}

To apply the network profile in the middle of the session, use :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" -H "Content-Type: application/json" -d '{"networkProfile":"2g-gprs-good"}' -X PUT "https://api-cloud.browserstack.com/app-automate/sessions/<sessionid>/update_network.json"

Note: Use driver.session_id command to get the session id.

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 (%)

To apply a custom network profile at the start of the session, use :

DesiredCapabilities desiredCapabilities = new DesiredCapabilities();
desiredCapabilities.setCapability("browserstack.customNetwork", "1000, 1000, 100, 1");

var capabilities = {
	'browserstack.customNetwork': '1000, 1000, 100, 1'
}

DesiredCapabilities capability = new DesiredCapabilities();
capability.SetCapability("browserstack.customNetwork", "1000, 1000, 100, 1");

$capabilities = new DesiredCapabilities();
$capabilities->setCapability("browserstack.customNetwork", "1000, 1000, 100, 1");

desired_cap = {
	'browserstack.customNetwork': '1000, 1000, 100, 1'
}

desired_caps = {
    'browserstack.customNetwork': '1000, 1000, 100, 1'
}

To apply a custom network profile in the middle of the session, use :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" -H "Content-Type: application/json" -d '{"customNetwork":"1000,1000,100,1"}' -X PUT "https://api-cloud.browserstack.com/app-automate/sessions/<sessionid>/update_network.json"

Note: Use driver.session_id command to get the session id.

Need some help?

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