[WebUI] Is Element Text
Last updated: August 2026
Prerequisites
This keyword is available from Katalon Studio version 11.2.0+.
Description​
Check whether 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: isElementText
A condition that is not satisfied normally returns false and does not fail the test step. Unexpected execution errors apply the configured failure handling. If execution continues after an error, the keyword returns false.
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. |
Returns​
| Return Type | Description |
|---|---|
| boolean | Returns true when the element's text exactly matches expectedText; for elements whose tag name starts with flt-, an exact aria-label match also satisfies the condition; otherwise, returns false. |
Examples​
boolean result = WebUI.isElementText(findTestObject('Page_Main/element'), 'Submit', 10)
boolean handledResult = WebUI.isElementText(findTestObject('Page_Main/element'), 'Submit', 10, FailureHandling.CONTINUE_ON_FAILURE)