Simulate network conditions

Simulate different network connections and conditions to test the performance of your apps when testing on BrowserStack device cloud. Under default network settings, each device in your test runs will have unhindered WiFi connection with Internet connectivity.

With Network simulation, you can change the WiFi connection to simulate the speeds of a network profile such as 2G or 3G which controls bandwidth, latency and packet loss. You can also simulate no internet using “no-network” network profile.

Use the browserstack.networkProfile capability to simulate different network conditions.

Example:

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'
}

List of supported network profiles:

Switch to a network profile in the middle of your test run

Use our REST API if you want to switch between different network profiles in the middle of your test run.

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

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"

Get session id using driver.session_id once the driver is created

Simulate a custom network condition

If you want to simulate a custom network condition, use the browserstack.customNetwork capability:

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'
}

Switch to a custom network profile in the middle of your test run

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"

Get session id using driver.session_id once the driver is created