Browser automation actions
Browser automation actions enable users to interact with web applications and components through UI elements. Web UI elements, also called Web elements, describe uniquely the web components that the action is going to handle.
To perform web automation, you first need to create a new browser instance. You can achieve this using the Launch Browser actions, which support Microsoft Edge, Google Chrome, Mozilla Firefox, and Internet Explorer. With the Launch Browser actions, you can also specify whether the web page should be launched on your local desktop or in a virtual desktop environment.
Note
To launch a browser on a virtual desktop, first capture at least one UI element within that desktop. This element needs to be available in the UI element repository of your flow.
To add a new UI element, select Add UI element through the deployed browser automation action or the UI elements pane of the flow designer.
All web-related UI elements are specified by one or more CSS selectors - web selectors - that pinpoint the hierarchical structure of the component on the page. Selectors use the > notation to indicate that each element is contained within the element on its left.
Although web selectors are created automatically when adding UI elements, some particular scenarios need manually created selectors. When a custom web selector is needed, you can create your own by either editing an existing selector or building one from scratch.
To develop more dynamic web flows, replace the Equals to operators with other operators or regular expressions. Additionally, if the value of a web selector's attribute depends on the results of previous actions, use variables instead of hard-coded values.
Note
To find more information about developing web flows and creating custom web selectors for Web elemements, go to Automate web flows and Build a custom selector.
Extract data from web page
Extract data from specific parts of a web page in the form of single values, lists, rows, or tables.
For more information on how to use this action, go to Web data extraction.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the UI element on web page to extract data from | |
| Extraction parameters | No | Datatable | The parameters to use when extracting data. Depending on the extraction mode, this parameter accepts different data. | |
| Max web pages to process | No | Numeric value | The maximum number of web pages to process | |
| Send physical click for next page | N/A | Boolean value | False | Specify whether to physically move the mouse cursor over the page prior to clicking. A physical click is required for cases where emulated clicks to the page don't perform the intentional action on the element. As this option requires the browser window to be focused, it will automatically bring it to the foreground. |
| Page CSS selector | No | Text value | The page CSS selector | |
| Extraction mode | N/A | Undefined, Single value, Handpicked values, List, Table, Entire HTML table | Single value | Specify what to extract from the web page |
| Use paging | N/A | Boolean value | False | Specify whether to use paging |
| Get all web pages | N/A | Boolean value | False | Specify whether to get all web pages |
| Process data upon extraction | N/A | Boolean value | False | Specify whether to process extracted data to present them exactly as displayed in the webpage. Processing of extracted data includes displaying of the information nested in iframes and filtering through hidden or visible elements. For larger datasets, having this option enabled isn't recommended as it will increase the extraction time. |
| Timeout | Yes | Numeric value | 60 | Set the time in seconds that you want to wait for the extraction to be completed before the action fails |
| Store data mode | N/A | Variable, Excel spreadsheet | Variable | Specify whether to store the extracted data in a variable or an Excel spreadsheet |
Variables produced
| Argument | Type | Description |
|---|---|---|
| ExcelInstance | Excel instance | The Excel instance with the extracted data. Use this instance to manipulate the spreadsheet (or save and close it) by using the dedicated Excel actions. |
| DataFromWebPage | Datatable | The extracted data in the form of a single value, list, data row, or data table. |
Exceptions
| Exception | Description |
|---|---|
| Failed to extract data | Indicates a problem extracting data |
| Failed to launch Excel instance | Indicates a problem launching an Excel instance |
| Failed to write values to Excel | Indicates a problem writing the values to an Excel |
Get details of web page
Get a property of a web page, such as its title or its source text.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| Get | N/A | Web page description, Web page meta keywords, Web page title, Web page text, Web page source, Web browser's current URL address | Web page description | Select the information to retrieve from the web page |
Variables produced
| Argument | Type | Description |
|---|---|---|
| WebPageProperty | Text value | The details retrieved from the web page |
Exceptions
| Exception | Description |
|---|---|
| Failed to get details of web page | Indicates a problem getting the details of the specified web page |
Get details of element on web page
Get the value of an element's attribute on a web page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the UI element on web page to get details from | |
| Attribute name | No | Text value | Own Text | Enter or select the attribute whose value to retrieve |
Variables produced
| Argument | Type | Description |
|---|---|---|
| AttributeValue | Text value | The value of the web element's attribute |
Exceptions
| Exception | Description |
|---|---|
| Failed to retrieve attribute of UI element on web page | Indicates a problem retrieving attribute of web page element |
Take screenshot of web page
Take a screenshot of the web page (or an element of the web page) currently displayed in the browser and save the image into a file or to the clipboard.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| Capture | N/A | Entire web page, Specific element | Entire web page | Specify whether to capture the entire web page or only a specific element of it |
| UI element | No | UI element | Select the UI element on web page to capture | |
| Save mode | N/A | Clipboard, File | Clipboard | Specify whether to save the image into a file or store it into the clipboard |
| Image file | No | File | Set the full path for the file to save the image capture | |
| File format | N/A | BMP, EMF, EXIF, GIF, JPG, PNG, TIFF, WMF | BMP | Select the format of the image file |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to save file | Indicates a problem saving the specified file |
| Failed to save in the clipboard | Indicates a problem while saving to the clipboard |
| Failed to take screenshot | Indicates a problem taking a screenshot |
Focus text field on web page
Set the focus on an input element of a web page and scroll it into view.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the UI element on web page to focus | |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to set input focus on web page text field | Indicates a problem setting input focus on the specified web page text field |
Populate text field on web page
Fill a text field in a web page with the specified text.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the text field to populate | |
| Text | No | Direct encrypted input or Text value | Enter the text to fill in the text field | |
| If field isn't empty | Yes | Replace text, Append text | Replace text | Specify whether to replace existing content, or to append. |
| Populate text using physical keystrokes | N/A | Boolean value | False | Emulate using physical keystrokes when populating text to UI text field elements. Physical keystrokes are required for cases that emulated text population doesn't perform the intentional action on the element. As this option requires the browser window to be focused, it will automatically bring it in the foreground. |
| Emulate typing | N/A | Boolean value | True | Specify whether to fill the text field at once by setting the value of the text box, or emulate a user typing by sending characters one by one. The latter method is slower, but required in some complex web pages. |
| Unfocus text box after filling it | N/A | Boolean value | False | Choose whether to unfocus the text box right after this action fills it with the specified text. If scraping autocompletion lists, this parameter should be set to False. |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely after populating the text field |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears after populating the text field |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to write on text field | Indicates a problem writing to the specified text field |
Set check box state on web page
Check or uncheck a check box in a web form.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the check box to set the state of | |
| Check box state | N/A | Checked, Unchecked | Checked | Select the check box state |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely after setting the check box state |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears after setting the check box state |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to set the state of the checkbox | Indicates a problem in setting the state of the specified check box |
Select radio button on web page
Select a radio button on the web page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | The radio button to select | |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely after selecting the radio button |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears after selecting the radio button |
| Dialog button to press | Yes | Text value | OK | The dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to select radio button | Indicates a problem in selecting the specified radio button |
Set drop-down list value on web page
Set or clear the selected options for a drop-down list in a web form.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the drop-down list to set its value | |
| Operation | N/A | Clear all options, Select options by name, Select options by index | Clear all options | Select whether to select a value or clear the selected value of the drop-down list |
| Option names | No | List of Text values | Enter an option or a list of options to be selected in the drop-down list. Multiple options make sense only when working with multi-selection lists. If the list is single-selection, then only the first option of the list specified will be used. | |
| Use regular expressions | N/A | Boolean value | False | Specify whether the option names values to interpret as a regular expression |
| Option indices | No | List of Numeric values | Enter an index or a list of indices to be selected in the drop-down list. Multiple options make sense only when working with multi-selection lists. If the list is single-selection, then only the first option of the list specified will be used. | |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely after setting the drop-down list value |
| Timeout for webpage load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears after setting the drop-down list value |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to set the selected option | Indicates a problem setting the selected drop-down list option |
Press button on web page
Press a web page button.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the button to press | |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely after pressing the button |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears after pressing the button |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to click on web page button | Indicates a problem clicking the specified web page button |
If web page contains
Mark the beginning of a conditional block of actions, depending on whether a specific piece of text or element exists in a web page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| Check if web page | N/A | Contains element, Doesn't contain element, Contains text, Doesn't contain text | Contains element | Check whether a specific text or web page element exists in a web page |
| UI element | No | UI element | Select the UI element on web page to check for | |
| Text | No | Text value | Enter the text on web page to check for |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Failed to communicate with the browser | Indicates that an error with the browser occurred |
Wait for web page content
Suspend the flow until a specific piece of text or web page element appears or disappears from a web page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| Wait for web page to | N/A | Contain element, Not contain element, Contain text, Not contain text | Contain element | Specify whether to wait for a specific text or web page element to appear or disappear in a web page |
| UI element | No | UI element | Select the UI element on web page to check for | |
| Text | No | Text value | Enter the text on web page to check for |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Wait for web page content failed | Indicates that the wait operation failed |
Launch new Internet Explorer
Launch a new instance or attach to a running instance of Internet Explorer for automating websites and web applications.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Launch mode | N/A | Launch automation browser, Launch new Internet Explorer, Attach to running Internet Explorer | Launch automation browser | Specify whether to launch the automation browser or a new instance of Internet Explorer or attach to an existing one |
| Attach to Internet Explorer tab | N/A | By title, By URL, Use foreground window | By title | Specify whether to attach to an Internet Explorer tab by its title, URL, or attach to the active tab of Internet Explorer running as the foreground window |
| Initial URL | No | Text value | Enter the URL of the web site to visit when the web browser is launched | |
| Tab title | No | Text value | Enter the title (or part of it) of the Internet Explorer tab to attach to | |
| Tab URL | No | Text value | Enter the URL (or part of it) of the Internet Explorer tab to attach to | |
| Window state | N/A | Normal, Maximized, Minimized | Normal | Specify whether to launch the browser window in normal, minimized, or maximized state |
| Target desktop | N/A | Local computer, Any virtual desktop that is either currently connected or has at least one UI element captured | Local computer | Set the connection string of the target desktop that the browser launches |
| Clear cache | N/A | Boolean value | False | Specify whether to clear the entire cache of the web browser right after launching it |
| Clear cookies | N/A | Boolean value | False | Specify whether to clear all stored cookies in the web browser right after launching it |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears while loading the initial web page |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
| Custom user agent string | Yes | Text value | Specify the custom user agent string for the runtime web helper. If this field remains empty, the runtime web helper uses by default the user agent string of Internet Explorer installed on the machine. |
Note
The Clear cache and Clear cookies options only work as intended if running in protected mode is disabled in the Internet options menu.
Variables produced
| Argument | Type | Description |
|---|---|---|
| InternetExplorer | Web browser instance | The Internet Explorer instance to use with browser automation actions |
Exceptions
| Exception | Description |
|---|---|
| Failed to launch Internet Explorer | Indicates a problem launching Internet Explorer |
| Invalid URL | Indicates that the provided URL was invalid |
Launch new Firefox
Launch a new instance or attach to a running instance of Firefox for automating websites and web applications.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Launch mode | N/A | Launch new Instance, Attach to running instance | Launch new Instance | Specify whether to launch a new instance of Firefox or attach to an existing one |
| Attach to Firefox tab | N/A | By title, By URL, Use foreground window | By title | Specify whether to attach to a Firefox tab by its title, URL, or attach to the active tab of Firefox running as the foreground window |
| Initial URL | No | Text value | Enter the URL of the web site to visit when the web browser is launched | |
| Tab title | No | Text value | Enter the title (or part of it) of the Firefox tab to attach to | |
| Tab URL | No | Text value | Enter the URL (or part of it) of the Firefox tab to attach to | |
| Window state | N/A | Normal, Maximized, Minimized | Normal | Specify whether to launch the browser window in normal, minimized, or maximized state |
| Target desktop | N/A | Local computer, Any virtual desktop that is either currently connected or has at least one UI element captured | Local computer | Set the connection string of the target desktop that the browser launches |
| Clear cache | N/A | Boolean value | False | Specify whether to clear the entire cache of the web browser right after launching it |
| Clear cookies | N/A | Boolean value | False | Specify whether to clear all stored cookies in the web browser right after launching it |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears while loading the initial web page |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
| Timeout | No | Numeric value | 60 | Set the time in seconds that you want to wait for the browser to be launched before the action fails |
| User data folder | N/A | Picture-in-Picture default, Browser default, Custom | Picture-in-Picture default | Specify the user data folder the browser uses when the flow runs in Picture-in-Picture. If Browser default is selected, the browser can't be opened on both the desktop and in Picture-in-Picture at the same time. Learn more |
| User data folder path | No | Folder | Specify the path of the user data folder the browser uses when the flow runs in Picture-in-Picture. Learn more |
Variables produced
| Argument | Type | Description |
|---|---|---|
| Browser | Web browser instance | The Firefox instance to use with browser automation actions |
Exceptions
| Exception | Description |
|---|---|
| Failed to launch Firefox | Indicates a problem launching Firefox |
| Invalid URL | Indicates that the provided URL was invalid |
Launch new Chrome
Launch a new instance or attach to a running instance of Chrome for automating websites and web applications.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Launch mode | N/A | Launch new Instance, Attach to running instance | Launch new Instance | Specify whether to launch a new instance of Chrome or attach to an existing one |
| Attach to Chrome tab | N/A | By title, By URL, Use foreground window | By title | Specify whether to attach to a Chrome tab by its title, URL, or attach to the active tab of Chrome running as the foreground window |
| Initial URL | No | Text value | Enter the URL of the web site to visit when the web browser is launched | |
| Tab title | No | Text value | Enter the title (or part of it) of the Chrome tab to attach to | |
| Tab URL | No | Text value | Enter the URL (or part of it) of the Chrome tab to attach to | |
| Window state | N/A | Normal, Maximized, Minimized | Normal | Specify whether to launch the browser window in normal, minimized, or maximized state |
| Target desktop | N/A | Local computer, Any virtual desktop that is either currently connected or has at least one UI element captured | Local computer | Set the connection string of the target desktop that the browser launches |
| Clear cache | N/A | Boolean value | False | Specify whether to clear the entire cache of the web browser right after launching it |
| Clear cookies | N/A | Boolean value | False | Specify whether to clear all stored cookies in the web browser right after launching it |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears while loading the initial web page |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
| Timeout | No | Numeric value | 60 | Set the time in seconds that you want to wait for the browser to be opened before the action fails |
| User data folder | N/A | Picture-in-Picture default, Browser default, Custom | Picture-in-Picture default | Specify the user data folder the browser uses when the flow runs in Picture-in-Picture. If Browser default is selected, the browser can't be opened on both the desktop and in Picture-in-Picture at the same time. Learn more |
| User data folder path | No | Folder | Specify the path of the user data folder the browser will use when the flow runs in Picture-in-Picture. Learn more |
Variables produced
| Argument | Type | Description |
|---|---|---|
| Browser | Web browser instance | The Chrome instance to use with browser automation actions |
Exceptions
| Exception | Description |
|---|---|
| Failed to launch Chrome | Indicates a problem launching Chrome |
| Invalid URL | Indicates that the provided URL was invalid |
Launch new Microsoft Edge
Launch a new instance or attach to a running instance of Microsoft Edge for automating websites and web applications.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Launch mode | N/A | Launch new Instance, Attach to running instance | Launch new Instance | Specify whether to launch a new instance of Microsoft Edge or attach to an existing one |
| Attach to Microsoft Edge tab | N/A | By title, By URL, Use foreground window | By title | Specify whether to attach to a Microsoft Edge tab by its title, URL, or attach to the active tab of Microsoft Edge running as the foreground window |
| Initial URL | No | Text value | Enter the URL of the web site to visit when the web browser is launched | |
| Tab title | No | Text value | Enter the title (or part of it) of the Microsoft Edge tab to attach to | |
| Tab URL | No | Text value | Enter the URL (or part of it) of the Microsoft Edge tab to attach to | |
| Window state | N/A | Normal, Maximized, Minimized | Normal | Specify whether to launch the browser window in normal, minimized, or maximized state |
| Target desktop | N/A | Local computer, Any virtual desktop that is either currently connected or has at least one UI element captured | Local computer | Set the connection string of the target desktop that the browser launches |
| Clear cache | N/A | Boolean value | False | Specify whether to clear the entire cache of the web browser right after launching it |
| Clear cookies | N/A | Boolean value | False | Specify whether to clear all stored cookies in the web browser right after launching it |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears while loading the initial web page |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
| Timeout | No | Numeric value | 60 | Set the time in seconds that you want to wait for the browser to be launched before the action fails |
| User data folder | N/A | Picture-in-Picture default, Browser default, Custom | Picture-in-Picture default | Specify the user data folder the browser uses when the flow runs in Picture-in-Picture. If Browser default is selected, the browser can't be opened on both the desktop and in Picture-in-Picture at the same time. Learn more |
| User data folder path | No | Folder | Specify the path of the user data folder the browser uses when the flow runs in Picture-in-Picture. Learn more |
Variables produced
| Argument | Type | Description |
|---|---|---|
| Browser | Web browser instance | The Microsoft Edge instance to use with browser automation actions |
Exceptions
| Exception | Description |
|---|---|
| Failed to launch Microsoft Edge | Indicates a problem launching Microsoft Edge |
| Invalid URL | Indicates that the provided URL was invalid |
Create new tab
Create a new tab and navigate to the given URL (supported in Microsoft Edge, Chrome, and Firefox).
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| URL to navigate to | No | Text value | Enter the URL, or a variable containing the URL, to navigate to | |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears while loading the web page |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
| Argument | Type | Description |
|---|---|---|
| NewBrowser | Web browser instance | The new web browser instance to use with browser automation actions |
Exceptions
| Exception | Description |
|---|---|
| Invalid URL | Indicates that the provided URL was invalid |
| Failed to create a new tab | Indicates a problem creating a new tab |
Go to web page
Navigate the web browser to a new page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| Navigate | N/A | To URL, Back, Forward, Reload web page | To URL | Specify where to navigate to |
| URL | No | Text value | Enter the URL to navigate to | |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the web page to load completely before proceeding |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears while loading the web page |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Failed to navigate to web page | Indicates a problem navigating to the specified web page |
| Invalid URL | Indicates that the provided URL was invalid |
Click link on web page
Click on a link or any other element of a web page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the UI element on web page to click | |
| Click type | N/A | Left click, Right click, Double click, Left button down, Left button up, Right button down, Right button up, Middle click | Left click | The kind of click to perform |
| Send physical click | N/A | Boolean value | False | Specify whether to physically move the mouse cursor over the element prior to clicking. A physical click is required for cases where emulated clicks don't perform the intentional action on the element. As this option requires the browser window to be focused, it will automatically bring it to the foreground. |
| Wait for page to load | N/A | Boolean value | True | Specify whether to wait for the new web page to load completely after clicking the link |
| Timeout for webpage to load | No | Numeric value | 60 | Set the time in seconds for page to load before the action throws an error |
| If a pop-up dialog appears | N/A | Close it, Press a button, Do nothing | Do nothing | Specify what to do if a pop-up dialog appears after clicking the link |
| Dialog button to press | Yes | Text value | OK | Enter the dialog button to press if a pop-up dialog appears |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to click UI element | Indicates a problem clicking the specified element |
Click download link on web page
Select a link in a web page that results in downloading a file.
Important
The Click download link on web page action only works in Internet Explorer, which has reached the end of its lifecycle. We recommend using HTTP actions instead.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the UI element on web page to click | |
| Destination folder | No | Folder | Enter or choose the full path of the folder, or a variable containing the folder, to save the downloaded file to |
Variables produced
| Argument | Type | Description |
|---|---|---|
| DownloadedFile | File | The file on the disk where the download is saved. This value is a filepath that consists of the download folder as specified above plus the name of the file as provided by the web server. |
Exceptions
| Exception | Description |
|---|---|
| Failed to download file | Indicates a problem downloading the specified file |
| Element with specified CSS selector not found | Indicates that a web page element with the specified CSS selector wasn't found |
| Failed to click UI element | Indicates a problem clicking the specified element |
| Failed to save file | Indicates a problem saving the specified file |
Run JavaScript function on web page
Run a JavaScript function on the web page and get the returned result.
Note
The migration to the Manifest V3 browser extensions affects this action. To find more information about Manifest V3 and how it affect the Run JavaScript function on web page action, go to Migration to Manifest V3.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| JavaScript function | Yes | Text value | function ExecuteScript() { /*your code here, return something (optionally); */ } | Enter the JavaScript function to run on the web page |
Variables produced
| Argument | Type | Description |
|---|---|---|
| Result | Text value | The result of the JavaScript function that ran |
Exceptions
| Exception | Description |
|---|---|
| Failed to run JavaScript | Indicates a problem running JavaScript |
Hover mouse over element on web page
Hover the mouse over an element of a web page.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to work with | |
| UI element | No | UI element | Select the UI element on web page to hover | |
| Move mouse to hover | No | Boolean value | False | Specify whether to physically move the mouse cursor over the element in order to hover the UI element. A physical hover is required for cases where emulated hover doesn't perform the intentional action on the element. As this option requires the browser window to be focused, it automatically brings it to the foreground. |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Failed to hover over element | Indicates a problem hovering over the specified element |
Close web browser
Close a web browser window.
Input parameters
| Argument | Optional | Accepts | Default Value | Description |
|---|---|---|---|---|
| Web browser instance | No | Web browser instance | Enter or choose the variable that contains the web browser instance to close |
Variables produced
This action doesn't produce any variables.
Exceptions
| Exception | Description |
|---|---|
| Failed to close the web browser | Indicates a problem closing the web browser |