[WebUI] Assert Element Text
Last updated: August 2026
Prerequisites
This keyword is available from Katalon Studio version 11.2.0+.
Description​
Assert that the element's text exactly matches expectedText; for elements whose tag name starts with flt-, an exact aria-label match also satisfies the condition within a specified timeout.
Keyword name: assertElementText
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.
Parameters​
| Parameter | Parameter Type | Required | Description |
|---|---|---|---|
to | TestObject | Yes | Represents the web element to evaluate. |
expectedText | String | Yes | Specifies the expected element text. The comparison is exact. |
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.assertElementText(findTestObject('Page_Main/element'), 'Submit', 10)
WebUI.assertElementText(findTestObject('Page_Main/element'), 'Submit', 10, FailureHandling.CONTINUE_ON_FAILURE)