Definition and Usage
This command allows you to wait for a specific element to appear or disappear in a window. It's useful for synchronizing your automation workflow with the application's UI state, ensuring that elements are present or absent before proceeding with subsequent actions.
Parameter Values
Input parameters
Parameter | Description | Possible Values | Required | Options / Notes |
Element | Select or capture an element to operate on | - | Yes | Use the Capture button to select the element |
Wait for | Specify whether to wait for an element to appear or disappear from the window | Contains element, Doesn't contain element | Yes | - |
Timeout | Set timeout | - | No | Enable this option to set a maximum wait time |
Timeout (s) | Set maximum wait time (in seconds) | - | No | Only required if Timeout is enabled |
Store result into | Store the result in a new variable | - | No | Stores a boolean value indicating success or failure |
Error handling
Parameter Name | Description |
Throw error & stop | When an error occurs, the action will trigger an error and stop the execution of the entire app. |
Retry command | If an error occurs, the action will retry the command in an attempt to resolve the issue and continue the process. |
Ignore error & continue | When an error occurs, the action will be ignored, and the workflow will continue without interruption. |
Variables produced
This action produces a variable that stores the result of the wait operation (true if the condition is met within the timeout period, false otherwise).
Using Variables in Conditions
You can use variables in the parameters of this command by clicking on the {x} icon next to input fields. This allows you to dynamically set values based on previously defined variables. For example:
You can use a variable to determine the timeout duration
The output variable can be used in subsequent conditional logic to branch your workflow based on whether the element appeared/disappeared as expected
Notes
If no timeout is specified, the command will wait indefinitely until the element appears or disappears
The element selection should be as specific as possible to avoid false detection
Consider using appropriate timeout values to prevent your automation from hanging indefinitely
The "Contains element" option waits for the element to appear, while "Doesn't contain element" waits for it to disappear