Skip to main content

How to check element status in conditional statement in Katalon Studio

In Web UI functional testing, you may want to ensure that an element is clickable, present, or visible before performing further actions on the element. The function used in such a case is verifyElementClickable with this specification:


The following code block demonstrates how to check the element status in a conditional statement. You may assume that the function WebUI.verifyElementClickable will return true if the element is clickable, and false if the element is not.

if (WebUI.verifyElementClickable(findTestObject('Test Objects/Pages/Login Page/elContinue - Wrong'))) {'Test Objects/Pages/Login Page/elContinue - Wrong'))
} else {'Test Objects/Pages/Login Page/elContinue'))

However, in practice, if the element is not found after timeout, the function does not return false. Instead, the exception below is returned:

Stack trace: com.kms.katalon.core.exception.StepFailedException: 
Unable to verify object 'Object Repository/Test Objects/Pages/Login Page/elContinue - Wrong' to be clickable (Root cause: Web element with id: 'Object Repository/Test Objects/Pages/Login Page/elContinue - Wrong' located by 'By.xpath: //button[.='Continue - Wrong']' not found)

You may find it confusing since the function has been used with the proper syntax and purpose as specified in the API documentation. Here’s why: In Katalon Studio, there are two overloading functions named verifyElementClickable.

Function 1 with default FailureHandling: Function 1 with default FailureHandling

Function 2 wich custom FailureHandling: Function 2 wich custom FailureHandling

The first function has a default FailureHandling parameter; while the second allows you to customize the parameter. This will determine the function’s behavior in some specific situations.

If you expect the function to return false if the element is not found, you will have to use the second function with the FailureHandling.OPTIONAL parameter. The following script will work with your expectation:

if (WebUI.verifyElementClickable(findTestObject('Test Objects/Pages/Login Page/elContinue - Wrong'), FailureHandling.OPTIONAL)) {'Test Objects/Pages/Login Page/elContinue - Wrong'))
} else {'Test Objects/Pages/Login Page/elContinue'))

We hope this tip will help resolve your problem when checking an element status before performing actions on it.