Simulate mobile network conditions

If you are using BrowserStack SDK, you can set the following capability within the browserstack.yml file to set the network profile:

Set network mode in the middle of a session

While your session is running, run the following cURL command in your terminal to set the network mode in the middle of the session:

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"

Replace <sessionid> with the ID of your ongoing test session. To get the session ID of your ongoing test, check out the code snippets in the get session ID section.

Simulate network conditions using predefined network profiles

Add any of the predefined network profiles provided by BrowserStack, as the value to the key in your test script to simulate various network conditions. Please note that this feature is not supported for proxy-unaware applications.

Set predefined network profile at the start of a session

Add the predefined network profile as a value to the capability to set a predefined network profile at the start of the session.

Set predefined network profile in the middle of a session

While your session is running, run the following cURL command in your terminal to add the predefined network profiles. To see the predefined network profiles, check out this section.

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"

Replace <sessionid> with the ID of your ongoing test session. To get the session ID of your ongoing test, check out the code snippets in the get session ID section.

Supported predefined network profile

The following table shows the supported predefined network profiles available in BrowserStack:

Simulate network conditions using a custom network profile

Create a custom network profile using supported parameters to simulate a network condition. Please note that this feature is not supported for proxy-unaware applications.

Set custom network condition at the start of a session

Use the following code snippet to set the network profile:

DesiredCapabilities capabilities = new DesiredCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("networkProfile", "no-network");

var capabilities = {
	'bstack:options' : {
		"networkProfile" : "no-network",
	},
}

AppiumOptions capabilities = new AppiumOptions();
Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("networkProfile", "no-network");

$caps = array(
    'bstack:options' => array(
        "networkProfile" => "no-network",
    ),
)

desired_cap = {
	'bstack:options' : {
		"networkProfile" : "no-network",
	},
}

capabilities = {
    'bstack:options' => {
        "networkProfile" => "no-network",
    },
}

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

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

AppiumOptions capabilities = new AppiumOptions();
capabilities.AddAdditionalCapability("browserstack.networkProfile", "no-network");

$caps = array(
"browserstack.networkProfile" => "no-network"
)

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

caps = Selenium::WebDriver::Remote::Capabilities.new
caps["browserstack.networkProfile"] = "no-network"

Set network mode in the middle of session

While your session is running, run the following cURL command in your terminal to set the network mode in the middle of the session:

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"

Replace <sessionid> with the ID of your ongoing test session. To get the session ID of your ongoing test, check out the code snippets in the get session ID section.

Simulate network conditions using predefined network profiles

Add any of the predefined network profiles provided by BrowserStack, as the value to the key in your test script to simulate various network conditions. Please note that this feature is not supported for proxy-unaware applications.

Set predefined network profile at the start of session

DesiredCapabilities capabilities = new DesiredCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("networkProfile", "2g-gprs-good");

var capabilities = {
	'bstack:options' : {
		"networkProfile" : "2g-gprs-good",
	},
}

AppiumOptions capabilities = new AppiumOptions();
Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("networkProfile", "2g-gprs-good");

$caps = array(
    'bstack:options' => array(
        "networkProfile" => "2g-gprs-good",
    ),
)

desired_cap = {
	'bstack:options' : {
		"networkProfile" : "2g-gprs-good",
	},
}

capabilities = {
    'bstack:options' => {
        "networkProfile" => "2g-gprs-good",
    },
}

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

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

AppiumOptions capabilities = new AppiumOptions();
capabilities.AddAdditionalCapability("browserstack.networkProfile", "2g-gprs-good");

$caps = array(
    "browserstack.networkProfile" => "2g-gprs-good"
)

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

caps = Selenium::WebDriver::Remote::Capabilities.new
caps["browserstack.networkProfile"] = "2g-gprs-good"

Set predefined network profile in the middle of session

While your session is running, run the following cURL command in your terminal to add the predefined network profiles. To see the predefined network profiles, check out this section.

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"

Replace <sessionid> with the ID of your ongoing test session. To get the session ID of your ongoing test, check out the code snippets in the get session ID section.

Supported predefined network profile

The following table shows the supported predefined network profiles available in BrowserStack:

Simulate network conditions using a custom network profile

Create a custom network profile using supported parameters to simulate a network condition. Please note that this feature is not supported for proxy-unaware applications.

Set custom network condition at the start of session

DesiredCapabilities capabilities = new DesiredCapabilities();
HashMap<String, Object> browserstackOptions = new HashMap<String, Object>();
browserstackOptions.put("customNetwork", "1000,1000,100,1");

var capabilities = {
	'bstack:options' : {
		"customNetwork" : "1000,1000,100,1",
	},
}

AppiumOptions capabilities = new AppiumOptions();
Dictionary<string, object> browserstackOptions = new Dictionary<string, object>();
browserstackOptions.Add("customNetwork", "1000,1000,100,1");

$caps = array(
    'bstack:options' => array(
        "customNetwork" => "1000,1000,100,1",
    ),
)

desired_cap = {
	'bstack:options' : {
		"customNetwork" : "1000,1000,100,1",
	},
}

capabilities = {
    'bstack:options' => {
        "customNetwork" => "1000,1000,100,1",
    },
}

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

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

AppiumOptions capabilities = new AppiumOptions();
capabilities.AddAdditionalCapability("browserstack.customNetwork", "1000,1000,100,1");

$caps = array(
"browserstack.customNetwork" => "1000,1000,100,1"

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

caps = Selenium::WebDriver::Remote::Capabilities.new
caps["browserstack.customNetwork"] = "1000,1000,100,1"