Skip to main content

GUI: Web Element Condition

Description

GUI: Web Element Condition step checks specified condition of web page element and returns a Boolean value in Web GUI automation.

Configurations

No.Field NameDescription
1Web Browser NameSelect any one Web Browser Name from the given list.Note: Select the same Web Browser Name which was selected in Start Browser Step.
2ConditionCondition to check on web page element.
3Criteria‘Criteria’ is the criterion to locate elements on Web GUI. GUI Spy can capture it in the Generate Step dialog. Upon Step Generation, it is populated in the step configuration. You may change criteria by choosing from the list in the ‘Step Generation’ window or step configuration.
Note: For list and description of criteria values, See Criteria Table. It is a mandatory field.
4Criteria ValueRelevant criteria value has to be specified.
5Element Index (Starts with 0)If you have checked Multiple elements with same criteria specify index of the element you want to locate.
Note: Select option FIRST if you want first element from the located element and select LAST if you want last element.
6Iframe IndicesSpecify Iframe Indices value. Specifying iframe indices ensures that the target element is identified correctly within the nested frame structure.
You can provide comma-separated values. For e.g.: 0,1,2.
7Iframe XpathIframe Xpath is a uniquely generated path that represents the location of an <iframe> or <frame> relative to the top-level window.

Iframe Xpath identifies each frame using a unique attribute such as id, name, or title if available, for example, iframe[@id='mainFrame'].

If no such attributes exist, the frame is identified by its position among sibling frames, like iframe[2] for the second iframe.

For nested structures, each frame is joined in sequence to form a full path. For example, if an element is inside an iframe[@id='outer'], which contains a frameset with a frame[@name='middle'], and that frame contains iframe[@title='inner'], the generated path would be:
iframe[@id='outer'];frame[@name='middle'];iframe[@title='inner'].

Note: If an iframe or frame has no id, name, or title, its origin (i.e., the src URL) will be used as a fallback in the path for unique identification. For example: iframe[@origin='https://example.com'].
8Frame IDProvide the current Iframe Id to target a specific iframe to perform the action.
Default Value: frameID
9Output Field NameName of the output field, which contains the evaluated Boolean value.Default Value: Output.

Condition

The following table contains the description of each condition.

No.Field NameDescription
1Is displayedCheck if web page element is displayed.
2Is enabledCheck if web page element is enabled.
3Is selectedCheck if web page element is selected.