[WebUI] Assert Element Not Checked
Last updated: August 2026
Prerequisites
This keyword is available from Katalon Studio version 11.2.0+.
Description​
Assert that the found element is not selected or checked within a specified timeout.
Keyword name: assertElementNotChecked
Katalon Studio polls the condition until it is satisfied or the timeout expires. If the condition is not satisfied, the keyword applies the configured failure handling: STOP_ON_FAILURE stops execution, CONTINUE_ON_FAILURE records a failed step and continues, and OPTIONAL logs a warning and continues.
The element must be found before its negative state is evaluated. A missing element does not satisfy this assertion. Use WebUI.assertElementNotPresent to assert that an element is absent.
Parameters​
| Parameter | Parameter Type | Required | Description |
|---|---|---|---|
to | TestObject | Yes | Represents the web element to evaluate. |
timeOut | int | Yes | Specifies the maximum time, in seconds, to wait for the condition. A negative value uses the configured WebUI element timeout. |
flowControl | FailureHandling | No | Specifies the failure handling behavior for execution failures. When omitted, this parameter uses the project default failure handling. |
Examples​
WebUI.assertElementNotChecked(findTestObject('Page_Main/element'), 10)
WebUI.assertElementNotChecked(findTestObject('Page_Main/element'), 10, FailureHandling.CONTINUE_ON_FAILURE)