Skip to main content

GUI: Web Wait Until

Description

GUI: Web Wait Until step waits for an element to be visible, enabled or present on the web page in Web GUI automation. The maximum wait time is until the delay specified.

Limitation The Step GUI: Web Wait Until will not work, if the browser is Mozilla Firefox and Expected condition is set to Alert Present.

Configurations

No.Field NameDescription
1Step NameName of the step. The name must be unique in a single workflow.
The data type is string, and the field is mandatory.
2Web 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.
3Expected ConditionSpecify the condition for the element from given list.
-Element visible
-Element invisible
-Element present
-Element to be clickable
-Text to be present in element
-Text to be present in element value
-Element checked
- Alert Present
-Element Selected
4Timeout (in Milliseconds)Maximum time in milliseconds to wait for the expected condition.Default Value: 0
5Criteria‘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.
For list and description see Criteria Table.
6Criteria ValueRelevant criteria value has to be specified.
7IframeIndices Specify 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.
Note: Field is not available for the following selected Expected Condition field:
- Text to be present in element - Text to be present in element value
8Iframe 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'].
10Frame IDProvide the current Iframe Id to target a specific iframe to perform the action.
Default Value: frameID
9Additional valueSelect an additional value that is required to complete the action depending on the selected criteria.
Note: This field is available when the following criteria is selected in the Expected Condition field:
- Text to be present in element
- Text to be present in element value Note: Similarly, in GUI Spy, the Additional value field is available when you select the specific options in the Expected Condition field.
Note

Similarly, in GUI Spy, the Additional value field is available when you select the specific options in the Expected Condition field.