Skip to main content

Supported actions

Learn the list of actions or operations that are permitted or supported in Katalon Cloud Studio (Beta). These actions are already pre-defined for users to accomplish tasks or functions in Katalon Cloud Studio (Beta).

You can use the following built-in keywords and add them as test steps to execute your test cases on a web browser.
Supported actionKeywordWhat does it do?Return valueThrows an error if

Check on the Checkbox object checkbox

check
  • Checks a checkbox when the user checks the checkbox object, or it checks on the label associated with the checkbox.
  • You can use this keyword with input[type=checkbox] or [role=checkbox] objects.

  • If the checkbox is already checked, the engine does nothing.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object you selected does not exist, or the local engine cannot check the object within the default timeout (30 seconds).

Click on object

click
  • Clicks on the center of the selected object.

  • The local engine scrolls the object into view if needed.

  • The local engine currently does not support clicking on iframe and shadow DOM elements.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object you selected does not exist, or the engine cannot click on the object within the default timeout (30 seconds).

Close the browsercloseBrowser
  • Closes the browser opened by the local engine.

  • If there is no browser to close, the local engine does nothing.

  • No return value

Double-click on object

doubleClick
  • Double-clicks on the center of the selected object.

  • The local engine scrolls the object into view if needed.

  • The local engine currently does not support clicking on iframe and shadow DOM elements.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist, or the engine cannot click on the object within the default timeout (30 seconds).

Enter text in Input field object

setText
  • Sets your provided text into an input field.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The value parameter is null.

  • The object does not exist, or the local engine cannot set your provided text within the default timeout (30 seconds).

Enter a password in Password field object

setEncryptedText
  • Sets your encrypted text into a field, which is usually the password field.

  • The encrypted text cannot be decrypted.

  • URL of the current browser window in string format.

  • There is no opened browser.

  • The locator of the test object is invalid.

  • The value parameter is null.

  • The object does not exist, or the engine cannot set encrypted text within the default timeout (30 seconds).

Get URL of the current browser windowgetURL
  • Gets the HTTP/HTTPS URL of the current browser window.

  • URL of the current browser window in string format.

  • There is no open browser.

Get inner text of object

getText
  • Gets the visible inner text of the object (the object that doesn't have attribute visibility: hidden or display: none), including sub-objects, without any leading or trailing whitespace.

  • The inner text of the object in string format.

  • There is no open browser.

  • The locator of the object is invalid.

  • The object does not exist within the default timeout (30 seconds).

Hover overhoverOver
  • Simulates the action of hovering the cursor over your target object.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist.

  • The local engine cannot hover over the object.

Open the browser and navigate to URL

openBrowser
  • Opens a browser and navigate to the specified URL.

  • If the browser has already been opened by the local engine, the local engine uses the opened browser to navigate to the given URL.

  • No return value

  • The URL parameter is invalid.

Scroll to object

scrollToElement
  • Scrolls your selected object into the center of the viewport of the browser window.

  • The object may not be scrolled completely to the center depending on the layout of the other objects.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist within the default timeout (30 seconds).

Select value from Dropdown object

selectOptionByValue
  • Selects an option from the drop-down list that matches the value you provided.

  • The local engine currently does not support selecting multiple options from a drop-down list.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The value parameter is null.

  • The object does not exist, or there is no option that matches the given value, or the local engine cannot select the object within the default timeout (30 seconds).

Take screenshot of the current viewporttakeScreenshot
  • Takes a screenshot of the current viewport.

  • The path to the screenshot.

  • There is no opened browser.

Uncheck on the Checkbox object checkbox

uncheck
  • Unchecks a checkbox.

  • If the checkbox is not checked, the engine does nothing.

  • You can use this keyword with input[type=checkbox] or [role=checkbox] objects.

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist, or the local engine cannot uncheck the object within the default timeout (30 seconds).

Verify element attribute value

verifyElementAttributeValue
  • Verifies if your selected object has an attribute with the specified name, and the attribute value matches your specified value within the default timeout (30 seconds).

  • No return value

  • There is no opened browser.

  • The locator of the object is invalid.

  • 3e523ff5-dd45-4bb5-8bda-251ee31d238f:comment:linh.hnguyen@katalon.com:1701234971603The 3e523ff5-dd45-4bb5-8bda-251ee31d238f

attributeName or attributeValue is undefined.

  • The object does not exist.

  • The object does not have the attribute, or the actual value of the object's attribute does not match the expected value.

Verify if the object is not present in the DOM (Document Object Model)

verifyElementNotPresent
  • Verifies if your selected object is not present in the DOM within your specified timeout.

  • true if the object is not present in the DOM.

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object is present in the DOM within the default timeout (30 seconds).

Verify if the object is present in the DOM (Document Object Model)

verifyElementPresent
  • Verifies if your selected object is present in the DOM within the default timeout (30 seconds).

  • true if the object is present in the DOM.

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object is not present in the DOM within the default timeout (30 seconds).

Verify that object contains expected-text

verifyElementText
  • Verifies the inner text of the object matches the text you provided within the default timeout (30 seconds).

  • true if the inner text of the object matches the expected text.

  • There is no opened browser.

  • The locator of the object is invalid.

  • The

expectedText21b3132c-e11d-4da3-aaff-42a6db96896a:comment:linh.hnguyen@katalon.com:1701234787825 parameter is undefined.21b3132c-e11d-4da3-aaff-42a6db96896a

  • The object does not exist, or the engine cannot get the text, or the actual inner text of the object does not match the expected text within the default timeout (30 seconds).

Verify that object is visible

verifyElementVisible
  • Verifies if the selected element is visible in the current viewport within the default timeout (30 seconds).

  • If the object is not visible, the display type is display:none, the computed style is visibility:hidden, and its size is zero.

  • true if the object is visible.

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist, or the object is not visible within the default timeout (30 seconds).

Verify URLwaitForElementPresent
  • Waits for a specific timeout for your selected object to be present in the DOM.

true if the object is found in the DOM within the specified timeout.
false if the object is not found in the DOM within the specified timeout.
  • There is no opened browser.

  • The locator of the object is invalid.

Wait for element present

verifyURL
  • Verifies if the URL of the current browser window matches your expected URL.

  • You can specify the expected URL as a complete URL string or using a wildcard.

  • No return value

  • There is no opened browser.

  • The

expectedURL parameter is undefined.

  • The actual URL of the current browser does not match the expected URL.

Verify number greater thanverifyNumberGreaterThan
  • Verifies if the object displays a number greater than the expected number. The keyword can compare number value, percentage value, and currency value.

  • true if the object is found greater than the expected number.

  • false if the object is found not greater than the expected number.

  • There is no opened browser.

  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

Verify number less thanverifyNumberLessThan
  • Verifies if the object displays a number less than the expected number. The keyword can compare number value, percentage value, and currency value.

  • true if the object is found less than the expected number.

  • false if the object is found not less than the expected number.

  • There is no opened browser.

  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

Verify number greater than or equalverifyNumberGreaterThanOrEqual
  • Verifies if the object displays a number greater than or equal to the expected number. The keyword can compare number value, percentage value, and currency value.
  • true if the object is found greater than or equal to the expected number.

  • false if the object is found not greater than or equal to the expected number.

  • There is no opened browser.
  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

An error is also thrown after a specific timeout if:

  • The object does not exist.

  • The actual number is not greater than or equal to the expected number.

  • The inner text of the object doesn't contain any number.

Verify number less than or equalverifyNumberLessThanOrEqual
  • Verifies if the object displays a number less than or equal to the expected number. The keyword can compare number value, percentage value, and currency value.
  • true if the object is found less than or equal to the expected number.

  • false if the object is found not less than or equal to the expected number.

  • There is no opened browser.
  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

An error is also thrown after a specific timeout if:

  • The object does not exist.

  • The actual number is not less than or equal to the expected number.

  • The inner text of the object doesn't contain any number.

Verify element checkedverifyElementChecked
  • Verifies if the object is checked.
  • The keyword can be used on
input[type=checkbox], input[role=checkbox], input[type=radio] or input[role=radio] objects.
  • true if the object is checked
  • There is no opened browser.
  • The locator of the object is invalid.

An error is also thrown after a specific timeout if:

  • The object does not exist.

  • The object is unchecked.

  • The object is not input[type=checkbox], input[role=checkbox], input[type=radio], or input[role=radio].

check

WebUI name

Check on the Checkbox object checkbox

Description

  • Checks a checkbox when the user checks the checkbox object, or it checks on the label associated with the checkbox.

  • You can use this keyword with input[type=checkbox] or [role=checkbox] objects.

  • If the checkbox is already checked, the engine does nothing.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object you selected does not exist, or the local engine cannot check the object within the default timeout (30 seconds).

click

WebUI name

Click on object

Description

  • Clicks on the center of the selected object.

  • The local engine scrolls the object into view if needed.

  • The local engine currently does not support clicking on iframe and shadow DOM elements.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object you selected does not exist, or the engine cannot click on the object within the default timeout (30 seconds).

closeBrowser

WebUI name

Close the browser

Description

  • Closes the browser opened by the local engine.

  • If there is no browser to close, the local engine does nothing.

Return value

No return value.

doubleClick

WebUI name

Double-click on object

Description

  • Double-clicks on the center of the selected object.

  • The local engine scrolls the object into view if needed.

  • The local engine currently does not support clicking on iframe and shadow DOM elements.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist, or the engine cannot click on the object within the default timeout (30 seconds).

setText

WebUI name

Enter text in Input field object

Description

Sets your provided text into an input field.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The value parameter is null.

  • The object does not exist, or the local engine cannot set your provided text within the default timeout (30 seconds).

setEncryptedText

WebUI name

Enter a password in Password field object

Description

  • Sets your encrypted text into a field, which is usually the password field.

  • The encrypted text cannot be decrypted.

Return value

The URL of the current browser window in string format.

Throws an error if

  • There is no opened browser.

  • The locator of the test object is invalid.

  • The value parameter is null.

  • The object does not exist, or the engine cannot set encrypted text within the default timeout (30 seconds).

getURL

WebUI name

Get URL of the current browser window

Description

Gets the HTTP/HTTPS URL of the current browser window.

Return value

The URL of the current browser window in string format.

Throws an error if

There is no open browser.

getText

WebUI name

Get inner text of object

Description

  • Gets the visible inner text of the object (the object that doesn't have attribute visibility: hidden or display: none), including sub-objects, without any leading or trailing whitespace.

Return value

The inner text of the object in string format.

Throws an error if

  • There is no open browser.

  • The locator of the object is invalid.

  • The object does not exist within the default timeout (30 seconds).

hoverOver

WebUI name

Hover over

Description

Simulates the action of hovering the cursor over your target object.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist.

  • The local engine cannot hover over the object.

openBrowser

WebUI name

Open the browser and navigate to URL

Description

  • Opens a browser and navigate to the specified URL.

  • If the browser has already been opened by the local engine, the local engine uses the opened browser to navigate to the given URL.

Return value

No return value.

Throws an error if

The URL parameter is invalid.

Edit timeout window for OpenBrowser keyword

You can now edit the timeout window when you select the OpenBrowser keyword as your test step in your Katalon Cloud Studio (Beta) test case.

The default timeout for openBrowser keyword is 30 seconds. In some cases, the AUTs may need more time to load, resulting in the test step failure.

You can now set the desired timeout (in seconds) for the engine to wait for the browser to be fully loaded. See the following steps how.

  1. Open your test case in Editor view.
  2. On the Editor view, hover and click the pencil icon to edit the existing OpenBrowser test step in your test case. Click pencil icon to edit the OpenBrowser test step.
  3. Tick the checkbox beside Override timeout and provide a timeout value in seconds. Click Override timeout and provide a value.
    Note: The timeout must be set to a value greater than 0 seconds.
  4. Click Save when done.
The timeout window is now updated with your desired value. Playback a Cloud Studio (Beta) test case to test your changes.

scrollToElement

WebUI name

Scroll to object

Description

  • Scrolls your selected object into the center of the viewport of the browser window.

  • The object may not be scrolled completely to the center depending on the layout of the other objects.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist within the default timeout (30 seconds).

selectOptionByValue

WebUI name

Select value from Dropdown object

Description

  • Selects an option from the drop-down list that matches the value you provided.

  • The local engine currently does not support selecting multiple options from a drop-down list.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The value parameter is null.

  • The object does not exist, or there is no option that matches the given value, or the local engine cannot select the object within the default timeout (30 seconds).

takeScreenshot

WebUI name

Take screenshot of the current viewport

Description

Takes a screenshot of the current viewport.

Return value

The path to the screenshot.

Throws an error if

There is no opened browser.

uncheck

WebUI name

Uncheck on the Checkbox object checkbox

Description

  • Unchecks a checkbox.

  • If the checkbox is not checked, the engine does nothing.

  • You can use this keyword with input[type=checkbox] or [role=checkbox] objects.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist, or the local engine cannot uncheck the object within the default timeout (30 seconds).

verifyElementAttributeValue

WebUI name

Verify element attribute value

Description

Verifies if your selected object has an attribute with the specified name, and the attribute value matches your specified value within the default timeout (30 seconds).

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The attributeName or attributeValue is undefined.

  • The object does not exist.

  • The object does not have the attribute, or the actual value of the object's attribute does not match the expected value.

verifyElementNotPresent

WebUI name

Verify if the object is not present in the DOM (Document Object Model)

Description

Verifies if your selected object is not present in the DOM within your specified timeout.

Return value

if the object is not present in the DOM.true.

verifyElementPresent

WebUI name

Verify if the object is present in the DOM (Document Object Model)

Description

Verifies if your selected object is present in the DOM within the default timeout (30 seconds).

Return value

if the object is present in the DOM.true.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object is not present in the DOM within the default timeout (30 seconds).

verifyElementText

WebUI name

Verify that object contains expected-text

Description

Verifies the inner text of the object matches the text you provided within the default timeout (30 seconds).

Return value

true if the inner text of the object matches the expected text.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The expectedText parameter is undefined.

  • The object does not exist, or the engine cannot get the text, or the actual inner text of the object does not match the expected text within the default timeout (30 seconds).

verifyElementVisible

WebUI name

Verify that object is visible

Description

  • Verifies if the selected element is visible in the current viewport within the default timeout (30 seconds).

  • If the object is not visible, the display type is display:none, the computed style is visibility:hidden, and its size is zero.

Return value

  • true if the object is visible.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The object does not exist, or the object is not visible within the default timeout (30 seconds).

waitForElementPresent

WebUI name

Wait for element present

Description

Waits for a specific timeout for your selected object to be present in the DOM.

Return value

  • true if the object is found in the DOM within the specified timeout.

  • false if the object is not found in the DOM within the specified timeout.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

verifyURL

WebUI name

Verify URL

Description

  • Verifies if the URL of the current browser window matches your expected URL.

  • You can specify the expected URL as a complete URL string or using a wildcard.

Return value

No return value.

Throws an error if

  • There is no opened browser.

  • The expectedURL parameter is undefined.

  • The actual URL of the current browser does not match the expected URL.

verifyNumberGreaterThan

WebUI name

Verify number greater than

Description

Verifies if the object displays a number greater than the expected number. The keyword can compare number value, percentage value, and currency value.

Return value

  • true if the object is found greater than the expected number.

  • false if the object is found not greater than the expected number.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

verifyNumberLessThan

WebUI name

Verify number less than

Description

Verifies if the object displays a number less than the expected number. The keyword can compare number value, percentage value, and currency value.

Return value

  • true if the object is found less than the expected number.

  • false if the object is found not less than the expected number.

Throws an error if

  • There is no opened browser.

  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

verifyNumberGreaterThanOrEqual

WebUI name

Verify number greater than or equal

Description

Verifies if the object displays a number greater than or equal to the expected number. The keyword can compare number value, percentage value, and currency value.

Return value

  • true if the object is found greater than or equal to the expected number.

  • false if the object is found not greater than or equal to the expected number.

Throws an error if

  • There is no opened browser.
  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

An error is also thrown after a specific timeout if:
  • The object does not exist.

  • The actual number is not greater than or equal to the expected number.

  • The inner text of the object doesn't contain any number.

verifyNumberLessThanOrEqual

WebUI name

Verify number less than or equal

Description

Verifies if the object displays a number less than or equal to the expected number. The keyword can compare number value, percentage value, and currency value.

Return value

  • true if the object is found less than or equal to the expected number.

  • false if the object is found not less than or equal to the expected number.

Throws an error if

  • There is no opened browser.
  • The locator of the object is invalid.

  • The expectedNumber parameter is undefined.

An error is also thrown after a specific timeout if:
  • The object does not exist.

  • The actual number is not less than or equal to the expected number.

  • The inner text of the object doesn't contain any number.

verifyElementChecked

WebUI name

Verify element checked

Description

  • Verifies if the object is checked.
  • The keyword can be used on the following objects:
    • input[type=checkbox]
    • input[type=radio]

    • input[role=radio]

Return value

true if the object is checked.

Throws an error if

  • There is no opened browser.
  • The locator of the object is invalid.

An error is also thrown after a specific timeout if:
  • The object does not exist.

  • The object is unchecked.

  • The object is not input[type=checkbox], input[role=checkbox], input[type=radio], or input[role=radio].

Was this page helpful?