[WebUI] Is Element Attribute Value
Last updated: August 2026
Prerequisites
This keyword is available from Katalon Studio version 11.2.0+.
Description​
Check whether the value of the named attribute exactly matches attributeValue within a specified timeout.
Keyword name: isElementAttributeValue
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. |
attributeName | String | Yes | Specifies the name of the attribute to evaluate. |
attributeValue | String | Yes | Specifies the expected attribute value. 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 value of the named attribute exactly matches attributeValue; otherwise, returns false. |
Examples​
boolean result = WebUI.isElementAttributeValue(findTestObject('Page_Main/element'), 'class', 'active', 10)
boolean handledResult = WebUI.isElementAttributeValue(findTestObject('Page_Main/element'), 'class', 'active', 10, FailureHandling.CONTINUE_ON_FAILURE)