- desired capabilities
Most Common Desired Capabilities
Browser Console Debug Logs
Geolocation Emulation
Bypass Unsafe Download Prompt
Geolocation for Chrome & Firefox
Custom User Profile in Chrome
Emulate Mobile Devices (Chrome)
Add Chrome Extension
Network Throttling
Network Logs
Biometric Authentication
Enable App Resigning in iOS
Enable Capturing Screenshots (Android & iOS)
Configure Android WebViews
Incognito/Private mode
Set Google Play Store Credentials
Basic Authentication [Safari]
Common Desired Capabilities
Below are a few of the most commonly used Desired Capabilities in executions using Testsigma:
Chrome
| Description | Capability | Data Type | Value |
|---|---|---|---|
| Accept insecure/expired certificates | acceptInsecureCerts | boolean | true |
| Changing User Agent | goog:chromeOptions | String | {"args":["--user-agent=USER_AGENT_STRING_HERE"]} For Example: {"args":["--user-agent=Mozilla/5.0 (Linux; <Android Version>; <Build Tag etc.>) AppleWebKit/<WebKit Rev> (KHTML, like Gecko) Chrome/<Chrome Rev> Mobile Safari/<WebKit Rev>"]} |
| Adding a single Chrome Extension to session | goog:chromeOptions | String | {"extensions":["path/to/extension"]} For more details on adding Testsigma Chrome Extension to a session using Desired Capabilities, refer to the documentation on adding Chrome Extension to a session using Desired Capabilities |
| Adding Chrome Extensions to session | goog:chromeOptions | String | {"extensions":["path/to/extension1"],["path/to/extension2"]} For more details on adding Testsigma Chrome Extension to a session using Desired Capabilities, refer to the documentation on adding Chrome Extension to a session using Desired Capabilities |
| Setting mobile device Emulation | goog:chromeOptions | String | {"mobileEmulation":{"deviceName":"iPhone X"}} For more details on configuring Desire Capabilites, refer to the documentation on configuring Desired Capabilities for emulating mobile devices using Chrome Browser |
| Disabling Browser Notifications | goog:chromeOptions | String | {“args”:[“--disable-notifications”]} |
| Setting custom profile for Browser data | goog:chromeOptions | String | {"args":["user-data-dir=/path/to/your/custom/profile"]} For more details on opening Chrome with the user-defined profile in Testsigma using Desired Capabilities, refer to the documentation on opening Chrome with the user-defined profile in Testsigma using Desired Capabilities |
| Setting the Geolocation (Chrome) | {"profile.default_content_setting_values.geolocation": 1 } 51.50735, -0.12776, 100 For more details on manually setting geographical location for test cases using Desired Capabillities, refer to the documentation on manually setting a geographical location for test cases using Desired Capabilities |
||
| Bypassing Chrome download protection (Keep/discard promptly for file downloads) |
goog:chromeOptions | String | {"prefs":{"safebrowsing.enabled":"true"}} For more details on avoiding unsafe download prompt from Google Chrome, refer to the documentation on avoiding unsafe download prompt for Google Chrome? |
| Enable the provision of notifications and the inclusion of fabricated media streams. | |||
| Disable Chrome Alert Notifications | goog:chromeOptions | String | {"args":["--disable-notifications"]} |
Morzilla Firefox
| Description | Capability Name | Data Type | Value |
|---|---|---|---|
| Setting the Geolocation (Firefox) | firefoxprofile | String | {"geo.prompt.testing": true, "geo.prompt.testing.allow": true, "geo.enabled": true, "geo.wifi.uri": "data:application/json,{"location": {"lat": 34.052235, "lng": -118.243683}, "accuracy": 100.0}" } For more details on manually setting geographical location for test cases using Desired Capabillities, refer to the documentation on manually setting a geographical location for test cases using Desired Capabilities |
| Accept insecure/expired certificates | accept_untrusted_certs | boolean | True |
Microsoft Edge
| Description | Capability Name | Data Type | Value |
|---|---|---|---|
| Accept insecure/expired certificates | acceptInsecureCerts | Boolean | True |
| Execute tests in Private browsing | MsOptions | String | {"args":["--inprivate"]} |
Execution Timeouts Specific in Testsigma Labs
| Description | Capability Name | Data Type | Value |
|---|---|---|---|
| Settings user-defined Step timeout duration - As a safety measure to prevent tests from running too long after something has gone wrong, Testsigma limits how long a browser can wait for a test to send a new command. | idleTimeout | Integer | 90 minimum - 0 default - 90 maximum - 1000 For more details on setting Sauce Labs environment specific settings in Testsigma, refer to the documentation on setting Sauce Labs environment-specific settings(step timeout, maximum test duration) |
| Settings user-defined maximum test duration - As a safety measure to prevent tests from running indefinitely, Sauce limits the duration of tests to 30 minutes by default. | maxDuration | Integer | 3600 minimum - 0 default - 3600 maximum - 10800 For more details on setting Sauce Labs environment specific settings in Testsigma, refer to the documentation on setting Sauce Labs environment-specific settings(step timeout, maximum test duration) |
Environment Customizations in Testsigma Labs
| Description | Capability | Data Type | Value |
|---|---|---|---|
| Setting the Timezone of the execution Environment | timeZone | String | Madrid You can get the list of Timezone locations from here: https://en.wikipedia.org/wiki/Listoftzdatabasetime_zones Use the City name without the Continent Name and replace underscores with space |
| Getting Excecution Console log of each url | extendedDebugging | Boolean | True For more details on enabling Browser Console debudding logs, refer to the documentation on enabling browser console debugging logs |
Environment Customizations in BrowserStack
| Description | Capability | Data Type | Value |
|---|---|---|---|
| Enable Visual Logs in BrowserStack | browserstack.debug | Boolean | true |
| Enable Local Testing in BrowserStack | browserstack.local | Boolean | true |
| Enable Browser Console logs in Browserstack | String | warnings For more details on enabling Browser Console debudding logs, refer to the documentation on enabling browser console debugging logs |
Android Specific
| Description | Capability | Data Type | Value |
|---|---|---|---|
| Persist App data in local Android devices across Hybrid Test sessions | noReset | boolean | true |
| Automatically grant required app permissions based on the Android manifest during installation. | autoGrantPermissions | boolean | true |
iOS Specific
| Description | Capability | Data Type | Value |
|---|---|---|---|
| Automatically approve all permission pop-ups, including privacy access requests for location, contacts, and photos. | autoAcceptAlerts | boolean | true |
| Automatically dismiss all permission pop-ups, including privacy access permissions like location, contacts, and photos. | autoDismissAlerts | boolean | true |