Pass desired capabilities at runtime in Katalon Studio

Override desired capabilities in project settings

Pre-configured desired capabilities in the project settings can be overwritten by using the above sample code in the test script. 
 

For instance, in the example above, we defined the window size as 1200x600 in the desired capabilities in the project settings. To override this setting to open a chrome window sized 100x100, follow the subsequent steps: 
 

1. Open the test case in script mode. Now pass the desired capabilities to the same key with the capabilities defined in project settings. Place this code before the test script as usual to override the desired capabilities at runtime.
    

As we can see here , replace --window-size=1200,600 with --window-size=100,100. So we pass the two required capabilities as arguments, --window-size=100,100 and --incognito, to the args keys in the sample code. This sample code is placed before the test. 
 

import com.kms.katalon.core.configuration.RunConfiguration
RunConfiguration.setWebDriverPreferencesProperty("args", ["--window-size=100,100","--incognito"])

2. Complete writing the script or autocomplete it using Web Spy/Record Utility.

3.  Now run the test with chrome. 

We can see that an incognito window opens up in a 100x100 format.
 

Pass desired capabilities at runtime for remote execution

Here is another example wherein we will set up a remote execution environment as Windows 10. To do so, enter the following code before the test script:
 

import com.kms.katalon.core.webui.keyword.WebUiBuiltInKeywords as WebUI
import com.kms.katalon.core.configuration.RunConfiguration


RunConfiguration.setDriverPreferencesProperty('Remote', 'os', 'Windows')  
RunConfiguration.setDriverPreferencesProperty('Remote', 'os_version', '10')  


WebUI.openBrowser('google.com')

Frequently Asked Questions 

What is Katalon Studio?

Katalon is an automating testing software, that lets the users test web, mobile or desktop applications and APIs without coding, to deliver efficient and robust softwares to the consumers.
 

What are Desired Capabilities in Katalon Studio?

Desired capabilities are key-value pairs that help the user specify browser properties such as browser name, version, path of the driver etc. These desired capabilities can be defined in the Project > Settings > Desired Capabilities.
 

How can the desired capabilities be overwritten at runtime?

The pre-configured desired capabilities can be overwritten at runtime by explicitly defining the capabilities in code and adding the code snippet over the test script. 

Conclusion

In this blog, we successfully learnt how to pass desired capabilities at runtime and overwrite the pre-configured capabilities in the project settings. We saw some examples demonstrating this feature's use and how the output changed with the custom arguments. Share this article with your fellow ninjas if you found it helpful. Along with this, visit our platform Coding Ninjas Studio to read informational articles on important computer fundamentals like DBMS, DSA, Competitive Programming, Python, Java, etc. Happy Coding!!