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 |
| otherApps String array of uploaded app ids. Note: Maximum 3 app ids allowed. This capability has to be used along with app capability. |
Example: ["bs://<hashed app-id>", "bs://<hashed app-id>"] |
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.deviceLogs Required if you want to capture device logs for your test. |
true, false Default: true |
| browserstack.networkLogs Required if you want to capture network logs for your test. |
true, false Default: false |
| browserstack.acceptInsecureCerts Use this capability to avoid invalid certificate errors while using self-signed certificate to test your app. |
true, false Default: false |
| browserstack.appiumLogs Required if you want to capture raw appium logs for your test. |
true, false Default: true |
| browserstack.video Required if you want to enable video recording during your test. |
true, false Default: true |
| browserstack.appStoreConfiguration Required if you want to login to your google account on the devices in order to test the functionalities like Google Pay or Google In-app purchase. |
Example: { "username" : "play-store-email", "password" : "play-store-password" } |
| 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.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 |
|
browserstack.geoLocation Required if you want to test how your app behaves in specific countries. |
"CN" for China, "FR" for France, "IN" for India and "US" for United States of America Note: Complete list of of over 40+ countries can be found here. |
| browserstack.networkProfile Required if you want to simulate different network conditions from the list of existing network profiles. |
Example: 2g-gprs-good, 2g-gprs-lossy, 3g-umts-good etc. Complete list of network profiles can be found here. |
| browserstack.customNetwork Required if you want to simulate the custom network condition |
Example ('1000', '1000', '100', '1') download speed (kbps), upload speed (kbps), latency (ms), packet loss (%) |
| browserstack.resignApp Set this capability to false if you want to test features like, Push Notifications. Use this capability along with your Enterprise signed app in the app capability. Using this capability will disable resigning of your Enterprise signed 'app' so that you can test features like, push notifications on BrowserStack devices. |
true, false IOS (Default): true Android: Not required for Android. |
|
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: Supported only on Android. You can view the complete list of timezones on Wikipedia. |
| browserstack.uploadMedia Required if you want to use your uploaded images or videos in the test. Upload your custom media on BrowserStack servers using REST API. Use the hashed url returned as a result of the upload in this capability. |
Example: ["media://hashedid", "media://hashedid"] Note: - Only 5 files are allowed per test - Supported format for images are JPG, JPEG, PNG, GIF, BMP - Max file size allowed for images is 10MB - Supported format for videos are .mp4, .mov and .3gp - Max file size allowed for videos is 50MB |
Mobile capabilities
| Capability | Values |
|---|---|
| device Specifies a particular mobile device for the test environment. |
Android devices: Google Pixel 3, Google Pixel 3 XL, 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 S9, Samsung Galaxy S9 Plus, Samsung Galaxy A8, Samsung Galaxy Note 8, Samsung Galaxy Note 9, Samsung Galaxy Tab 4, Samsung Galaxy Tab S3 iOS devices: iPhone 6, iPhone 6S, iPhone 6S Plus, iPhone 7, iPhone 7 Plus, iPhone 8, iPhone 8 Plus, iPhone X, iPhone SE, iPhone XS, iPad 5th, iPad Pro, iPad 6th Note: All values are strings. |
| browserstack.appium_version Use this capability to set the Appium version in your test scripts. |
Android: 1.6.5 (default), 1.7.1, 1.7.2, 1.8.0, 1.9.1 iOS: 1.6.5, 1.7.0 (default), 1.7.1, 1.7.2, 1.8.0, 1.9.1 (default on iOS 12) |
| 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 S9: "8.0" Samsung Galaxy S9 Plus: "8.0" Samsung Galaxy A8: "7.1" Samsung Galaxy Note 4: "6.0" Samsung Galaxy Note 8: "7.1" Samsung Galaxy Note 9: "8.1" Samsung Galaxy Tab 4: "4.4" Samsung Galaxy Tab S3: "7.0" Google Nexus 9: "5.1" Google Nexus 6: "6.0" Google Pixel: "7.1" Google Pixel: "8.0" Google Pixel 2: "8.0" Google Pixel 2: "9.0" Google Pixel 3: "9.0" Google Pixel 3 XL: "9.0" iPhone 6S: "11.4" iPhone 6S Plus: "11.4" iPhone 6: "11.2" iPhone 7: "10.3" iPhone 7 Plus: "10.3" iPhone 8: "11.0" iPhone 8: "12.1" iPhone 8 Plus: "11.0" iPhone X: "11.0" iPhone SE: "11.2" iPhone XS: "12.0" iPhone XS: "12.1" iPhone XS Max: "12.0" iPhone XS Max: "12.1" iPad 5th: "11.0" iPad Pro: "11.2" iPad Pro 12.9: "11.4" iPad 6th: "11.3" |
| deviceOrientation Set the screen orientation of mobile device. |
portrait, landscape Default: portrait |
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.