Adjusting Network Connection

The Selenium Mobile JSON Wire Protocol Specification supports an API for getting and setting the network connection for a device. The API works through a bitmask, assigning an integer to each possible state:

Value (Alias)	Data	Wifi	Airplane Mode
0 (None)	0	0	0
1 (Airplane Mode)	0	0	1
2 (Wifi only)	0	1	0
4 (Data only)	1	0	0
6 (All network on)	1	1	0

iOS

Unfortunately, at the moment Appium does not support the Selenium network connection API for iOS.

Android

There are the following limitations:

Real Devices

• Changing Airplane Mode state only works for Android 6 and older
• Chaning data connection state works for Android 4.4 and older. Newer OS releases (5.0+) must be rooted in order to make the feature working (e. g. su binary should available)
• Changing Wi-Fi connection state should work for all Android versions

Emulators

• Changing Airplane Mode state only works for Android 6 and older
• Chaning data connection state should work for all Android versions
• Changing Wi-Fi connection state should work for all Android versions

Windows

Unfortunately, at the moment Appium does not support the Selenium network connection API for Windows.

// javascript
// set airplane mode
driver.setNetworkConnection(1)

// set wifi only
driver.setNetworkConnection(2)

// set data only
driver.setNetworkConnection(4)

// set wifi and data
driver.setNetworkConnection(6)

Retrieving the network connection settings returns the same bitmask, from which the status can be decoded.

// javascript
driver.getNetworkConnection().then(function (connectionType) {
  switch (connectionType) {
    case 0:
      // no network connection
      break;
    case 1:
      // airplane mode
      break;
    case 2:
      // wifi
      break;
    case 4:
      // data
      break;
    case 6:
      // wifi and data
      break;
  }
});