Skip to main content

Execution settings in Katalon Studio

Execution settings help define the desired behaviors that apply to the project during and after test execution.

To access default Execution Settings, from the main menu, select Project > Settings > Execution.

  • Default execution: The default environment that Katalon Studio uses for executing test scripts.
  • Log executed test steps: When enabled, the logs will include executed test steps. See View and customize execution log in Katalon Studio.
  • Default wait for element timeout (in seconds): The default timeout period that Katalon Studio waits for the application under test to be loaded when executing the automation test.
  • Hide hostname in test reports and log viewer: Hide the username and host address of the machine in test reports and log viewer.
  • Take screenshot when execution failed: When enabled, Katalon Studio will capture screenshot of the failed test suite. To learn how to access these screenshots, see View captured screenshots in Katalon Studio reports.
  • Record Video during execution: When enabled, you can choose to record your test execution with Browser-based Recorder or Screen-based Recorder.
  • Post-Execution Options
    • Open report: Specify whether the report generated after your test suite's execution finishes is to be opened immediately.
    • Terminate drivers: Specify when any driver remains after execution is terminated.

Execution settings help define the desired behaviors that apply to the project during and after test execution.

To access default Execution Settings, from the main menu, select Project > Settings > Execution.

Default execution
The default environment that Katalon Studio uses for executing test scripts.
Log executed test steps
When enabled, the logs will include executed test steps. Learn more.
Default wait for element timeout (in seconds)
The default timeout period that Katalon Studio waits for the application under test to be loaded when executing the automation test.
Hide hostname in test reports and log viewer
Hide the username and host address of the machine in test reports and log viewer.
Take screenshot when execution failed
When enabled, Katalon Studio will capture screenshot of the failed test suite. To learn how to access these screenshots, see View captured screenshots in Katalon Studio reports.
Record Video during execution
When enabled, you can choose to record your test execution with Browser-based Recorder or Screen-based Recorder.
Post-Execution Options
  • Open report: Specify whether the report generated after your test suite's execution finishes is to be opened immediately.
  • Terminate drivers: Specify when any driver remains after execution is terminated.

Edit JVM parameters

Important:
  • An active Katalon Studio Enterprise license.

You can edit VM arguments in the execution settings by going to Project > Settings > Execution > Launch Arguments.

In the VM Arguments tab, enter your arguments. VM Arguments entered in the executions settings of a project change the behavior of a Java process of each execution. For example:

To make sure if the configuration works, add this simple test case:

import com.kms.katalon.core.util.KeywordUtil
KeywordUtil.logInfo(System.getProperty("testme"))

Currently, Katalon Studio does not support VM arguments values containing space. Below is a list of the most used JVM Parameters:

  • Specify minimal and maximal heap sizes:
    • -Xms<heap size>[unit]
    • -Xmx<heap size>[unit]
    • -XX:MaxMetaspaceSize=<metaspace size>[unit]
  • Configure the JVM stack size, for example -Xss16M sets the stack size equal to 16 MB. Similarly letter k or K to indicate KB, m or M to indicate MB, and g or G to indicate GB:
    • Configure the stack size to be 16MB: -Xss16M

    • Configure the stack size to be 1024KB: -Xss1024K

  • Garbage collection implementation types:
    • Serial Garbage Collector: -XX:+UseSerialGC
    • Parallel Garbage Collector: -XX:+UseParallelGC
    • CMS Garbage Collector: -XX:+USeParNewGC
    • G1 Garbage Collector: -XX:+UseG1GC
  • Garbage collection logging:
    • Specify the log file rolling policy: -XX:+UseGCLogFileRotation
    • Denote the max number of log files that can be written for a single application life cycle: -XX:NumberOfGCLogFiles=< number of log files >
    • Specify the max size of the file: -XX:GCLogFileSize=< file size >[ unit ]
    • Denote the file's location: -Xloggc:/path/to/gc.log
  • Handling out of memory:
    • Dump heap into physical file in case of OutOfMemoryError: -XX:+HeapDumpOnOutOfMemoryError
    • Denote the path where the file is to be written: -XX:HeapDumpPath=./java_pid<pid>.hprof
    • Issue emergency commands to be executed in case of out of memory error: -XX:OnOutOfMemoryError="< cmd args >;< cmd args >"
    • Limits the proportion of the VM's time that is spent in GC before an OutOfMemory error is thrown: -XX:+UseGCOverheadLimit

WebUI settings

You can configure default behaviors and timeouts for Web UI test execution, such as page load timeouts and action delays, by navigating to Project > Settings > Execution > Web UI.

These settings decide Katalon Studio behaviors when executing WebUI test in your test project:

WebUI Project settings

  • Default Smart Wait: Tells the web driver to wait for the web page to become static before any operations are performed. See Smart Wait function.

  • Default Smart Locator: Available from Katalon Studio version 9.4.0, this installs Smart Locator extension when executing, and uses Smart Locator in Self-healing. Disabling this option might cause error to test cases that contains smart locators.

  • Default wait when IE hangs: Specifies Katalon Studio default waiting time when IE hangs.

  • Default page load timeout

    • Wait until the page is loaded: This enables Katalon Studio to wait for the web page to load completely, which can help with timeout error.
    • Wait for (in seconds): This enables Katalon Studio to wait for the web page to load completely within the specified default timeout period (in seconds).
  • Delay between actions: This enables Katalon Studio to wait between test steps when executing test cases in seconds and in milliseconds.

  • Enable smart web inspectors: Starting Katalon Studio 10.2.0 and later, this allows you to test web apps built on advanced web technologies like Flutter apps, Canvas elements, and closed Shadow DOM. Enable this only if your web AUT uses any of these technologies.

    tip

    If your web AUT does not use any of these AUTs, do not turn this on. For recording test cases on these types of WebUI AUT, use Web Recorder Plus.

Web Service settings

Important:
  • An active Katalon Studio Enterprise license.

You can set default settings for Web Service test execution by going to Project > Settings > Execution > Web Service. The following global configurations are applied to both RESTful and SOAP requests in a project.

  • Connection Timeout in milliseconds (0=unlimited): The time to establish the connection with the remote server. When it is set to 0 or left empty, Katalon waits for a response forever.

  • Socket Timeout in milliseconds (0=unlimited): The time waiting for data – after establishing the connection.

  • Max Response size in bytes: The maximum number of bytes Katalon Studio renders from a response. When it is set to 0 or left empty, Katalon Studio downloads a response regardless of its size. Please note that downloading a large response may affect the application's performance.

For your convenience, we provide a shortcut to these global settings in a test request view.

A test request view

Web Service settings in script view

You can set request timeout and maximum response size via a script using the built-in functions of Katalon Studio.

Request timeout
  • Override timeout settings of a project in a test case
    Map<String, Object> generalSettings = RunConfiguration.getExecutionGeneralProperties()
    generalSettings.put(RunConfiguration.REQUEST_CONNECTION_TIMEOUT, 3500)
    generalSettings.put(RunConfiguration.REQUEST_SOCKET_TIMEOUT, 3500)
  • Change timeout settings of a specific test request
    RequestObject request = findTestObject("Object Repository/Localhost") request.setConnectionTimeout(3500) request.setSocketTimeout(3500)

    // Or to unset the timeout request.setConnectionTimeout(RequestObject.TIMEOUT_UNSET) request.setSocketTimeout(RequestObject.TIMEOUT_UNSET)

    // Or to set the timeout to unlimited request.setConnectionTimeout(RequestObject.TIMEOUT_UNLIMITED) request.setSocketTimeout(RequestObject.TIMEOUT_UNLIMITED)
    // Or if you just want to set to its default value (The default value is set to unlimited) request.setConnectionTimeout(RequestObject.DEFAULT_TIMEOUT) request.setSocketTimeout(RequestObject.DEFAULT_TIMEOUT)
Maximum response time
Note:
  • Katalon Studio also supports setting the maximum response size of execution using -maxResponseSize in the command line. Learn more.

  • Override response size limit of a project in a test case

    Map<String, Object> generalSettings = RunConfiguration.getExecutionGeneralProperties()
    generalSettings.put(RunConfiguration.REQUEST_MAX_RESPONSE_SIZE, 400)
  • Change maximum response size setting of a specific test request

    RequestObject request = findTestObject("Object Repository/Basic Auth")
    request.setMaxResponseSize(400)

    // Or to unset response size limit. And so, the project's max response size setting will be used.
    request.setMaxResponseSize(RequestObject.MAX_RESPONSE_SIZE_UNSET)

    // Or to set response size limit to unlimited
    request.setMaxResponseSize(RequestObject.MAX_RESPONSE_SIZE_UNLIMITED)

    // Or if you just want to set to its default value (The default value is set to unlimited)
    request.setMaxResponseSize(RequestObject.DEFAULT_MAX_RESPONSE_SIZE)
Was this page helpful?