Definition and Usage
Take a screenshot of a specified UI element in a window and save it to a local folder. This command allows you to capture specific elements of an interface rather than the entire screen, making it useful for documentation, testing, or verification purposes.
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 a UI element |
Select folder | Please select the folder path to save screenshots | - | Yes | Choose a destination folder for the screenshot |
Image format | Image format | Jpeg, Png | Yes | Determines the file format of the saved image |
File name | Choose whether to auto-generate a filename or set a custom filename | Auto-generated, Custom | Yes | - |
Custom file name | Please enter the file name without suffix | - | Yes (if "Custom" is selected) | Do not include file extension |
Overwrite if file exists | If selected, if the generated file name already exists, the original file will be overwritten; otherwise, an error will be reported | - | No | Checkbox option |
Advanced settings
Parameter | Description | Possible Values | Required | Options / Notes |
Element timeout (s) | Wait time for element to appear (seconds) | - | No | Default: 20 seconds |
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 contains the full path to the saved screenshot file.
Using Variables in Conditions
You can use variables in parameter fields where the {x} icon appears. This allows you to dynamically set parameters based on previously defined variables. For example, you could use a variable to specify the folder path or custom filename based on values determined earlier in your workflow.
Notes
The UI element must be visible on screen at the time of capture
If the element cannot be found within the specified timeout period, the command will fail
For reliable results, ensure the target element is stable and not changing rapidly
The saved screenshot will only include the specified UI element, not the entire window or screen
When using custom filenames, ensure they comply with your operating system's filename requirements