Set desired capabilities for TestCloud environment

In a Katalon project, you can set desired capabilities for browsers and applications. These desired capabilities will be applied when you trigger execution in TestCloud environments from Katalon Studio or TestOps.

Here are some common use cases that desired capabilities become useful in web and mobile testing:

• Chrome/Chrome (headless): start Chrome maximized by default.
• Firefox/Firefox (headless): start Firefox at a default page.
• Start browser in private mode.
• Desired capabilities for remote server.
• acceptInsecureCerts: bypass, or implicitly trust, TLS certificates that the certificate service in the browser does not trust.
• autoGrantPermissions: automatically determine which permissions your app requires and grant them to the app.
• autoAcceptAlerts: automatically accept all alerts if they pop up.

This document shows you how to set desired capabilities when executing tests with TestCloud environments from TestOps and Katalon Studio.

Set TestCloud desired capabilities

Depending on where you trigger the execution, from Katalon Studio or TestOps interface, the settings for TestCloud desired capabilities may differ.

Note:

With the exception of TestCloud execution in Linux environments (browsers on Linux), you need to specify desired capabilities in Settings > Desired Capabilities > Web UI.

1. In Katalon Studio, open your project.

For execution triggered by TestOps scheduler

2. Locate the settings
   1. For Linux execution environments, .e.g, Chrome on Linux, go to Project Settings > Desired Capabilities > WebUI and select a browser type, for example Chrome.
      
   2. For desktop browsers on macOS, Windows, mobile browsers, and mobile native applications: Go to Project Settings > Desired Capabilities > Remote.
      
3. Input your desired capabilities.
4. Click Apply to save the configurations.
   After you commit the changes to your remote script repository, TestOps Scheduler will fetch these settings and apply when you trigger a test run. See: Use TestCloud in TestOps.

Execution triggered from Katalon Studio

5. Go to Project Settings > Desired Capabilities > TestCloud.
   
6. Input your desired capabilities.
   The following are desired capabilities, generated by Katalon Studio for TestCloud execution, that cannot be overwritten by manual input:

   • app
   • katalon:option: { "organizationId": "", "deviceVersion": "", "deviceId": "", "usingTunnel": }
   • platformName
   • deviceName
   • remoteWebDriverUrl
   • remoteWebDriverType
   • isEncrypted
   • readTimeout
   • testCloudRemoteOS
7. Click Apply to save the configurations.
   The desired capabilities in this section will be applied when you trigger a test run in TestCloud environment from Katalon Studio