Capabilities
Capabilities are a series of key-value pairs that allow customization of testing from within BrowserStack Automate.
Capabilities
Appium provides a series of capabilities that you can set for the Appium version you are running. Appium server on the BrowserStack will receive all the capabilities you set on the client side. You can also use BrowserStack specific capabilities to configure your tests. Below is the complete list of BrowserStack Capabilities we support for App testing:
Appium capabilities
| Capability | Values |
|---|---|
| app Accepts App URL returned after uploading an app on the BrowserStack servers or custom_id defined by you to upload an app. Upload the App using REST API. |
bs://<hashed app-id> or custom_id |
| automationName Set the automation engine to use |
UIAutomator2, XCUITest, Appium Android (Default): UIAutomator2 iOS (Default): XCUITest |
Note: Refer to complete list of Appium supported capabilities
Test configuration capabilities
| Capability | Values |
|---|---|
| project Allows the user to specify a name for a logical group of builds. |
Example: loginformproject Default: Untitled Project |
| build Allows the user to specify a name for a logical group of tests. |
Example: build 4.5 Default: Untitled Build |
| name Allows the user to specify an identifier for the test run. |
Example: logintest |
| browserstack.local Required if you are testing against internal/local servers. |
true, false Default: false |
| browserstack.debug Required if you want to generate screenshots at various steps in your test. |
true, false Default: false |
| browserstack.video Required if you want to enable video recording during your test. |
true, false Default: true |
| browserstack.app_version Required if you want to test previously uploaded apps under same custom_id. Acceptable values are '-1', '-2' or so on. This will pick the latest-1 or latest-2 etc. version of your uploaded builds to install on your target device. Note: 'browserstack.app_version' capability can be used only if you use custom_id or shareable_id in the 'app' capability of your test. If you use app_url in the 'app' capability, Appium will install the app corresponding to the app_url ignoring the browserstack.app_version capability. |
-1, -2 and so on Default: Latest uploaded app version under the custom_id |
| browserstack.timezone Required if you want to configure tests to run on a custom time zone. |
UTC, New_York (for America/New_York), Los_Angeles (for America/Los_Angeles), La_Rioja (for America/Argentina/La_Rioja) Note: You can view the complete list of timezones on Wikipedia. |
| browserstack.gpsLocation Required if you want to simulate the location of the device to a particular GPS location. |
latitude, longitude Acceptable range for latitude is -90 to +90 and for longitude is -180 to +180. Example: 40.730610,-73.935242 Default: 0,0 |
Mobile capabilities
| Capability | Values |
|---|---|
| device Specifies a particular mobile device for the test environment. |
Android devices: Google Pixel 2, Google Pixel, Google Nexus 6, Google Nexus 9, Samsung Galaxy S5, Samsung Galaxy S6, Samsung Galaxy S7, Samsung Galaxy Note 4, Samsung Galaxy S8, Samsung Galaxy S8 Plus, Samsung Galaxy Note 8, Samsung Galaxy Tab 4 iOS devices: iPhone 7, iPhone 7 Plus, iPhone 8, iPhone 8 Plus, iPhone X, iPhone SE, iPad 5th, iPad Pro Note: All values are strings. |
| browserstack.appium_version Use this capability to set the Appium version in your test scripts. |
1.6.5, 1.7.1, 1.7.2 Android (Default): 1.6.5 iOS (Default): 1.7.0 (iOS only supports this version) |
| os OS you want to test. |
ios, android |
| os_version Use this capability to specify the OS version of the device. |
Samsung Galaxy S5: "4.4" Samsung Galaxy S6: "5.0" Samsung Galaxy S7: "6.0" Samsung Galaxy S8: "7.0" Samsung Galaxy S8 Plus: "7.0" Samsung Galaxy Note 4: "6.0" Samsung Galaxy Note 8: "7.1" Samsung Galaxy Tab 4: "4.4" Google Nexus 9: "5.1" Google Nexus 6: "6.0" Google Pixel: "7.1" Google Pixel: "8.0" Google Pixel 2: "8.0" iPhone 7: "10.3" iPhone 7 Plus: "10.3" iPhone 8: "11.0" iPhone 8 Plus: "11.0" iPhone X: "11.0" iPhone SE: "11.2" iPad 5th: "11.0" iPad Pro: "11.2" |
| deviceOrientation Set the screen orientation of mobile device. |
portrait, landscape Default: portrait |
| realMobile Use this flag to test on a physical mobile device. |
true, false Default: false |
We have following overriding rules specific to App testing:
- all the emulator specific capabilities will not work, as your tests will always run against real devices
- Appium's noReset and fullreset capability will not work as we always uninstall the app and clean up the device at the end of each session
- Appium's platformVersion capability will be ignored
- The value ANY if given to any parameter is same as the parameter preference not specified.