Browser package

The Browser package contains actions that enable you to download files, find broken links, and launch a website. This package supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers.

Actions in the Browser package

The Browser package includes the following actions:


Action	Description
Close	Closes a browser window or tab. Note: This action supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Select to close the tab, window, or all browsers: Tab: Closes the selected tab. Select the browser tab from the list of active supported browser tabs or insert a window variable. You can use a regular expression (regex) to identify a window title. Select the regular expression either as a String or Pattern for each regular expression condition and enter the value. By default, the Window title field is case-sensitive. You can enable Case insensitive regex flag to identify a window title that is not case-sensitive. To identify a static window or browser title and a title with a wildcard character, enable the Case sensitive option if you want the letter case to match. Disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum version of the Bot Agent installed on your system is the version that is released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then the window title will still be identified only with matching letter case (case-sensitive) by default. For example, you can enter the String value as `((\w)-Notepad` for all the window title names starting with `((\w)-Notepad`, or use Pattern such as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. Ensure that when you add the string input as `-title`, the application with the specific title is open. `` is just a character and not a wild card character. When you use a regular expression of type Pattern with -title as the input value for a window title in any action, the bot might encounter a run time error since the input value `-title` is incorrect. Ensure that you use valid regex patterns. Window: Closes the window of the selected tab. Select the window from the list of active supported windows or insert a window variable. You can use a regular expression (regex) to identify a window title. Select the regular expression either as a String or Pattern for each regular expression condition and enter the value. By default, the Window title field is case-sensitive. You can enable Case insensitive regex flag to identify a window title that is not case-sensitive. To identify a static window or browser title and a title with a wildcard character, enable the Case sensitive option if you want the letter case to match. Disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum version of the Bot Agent installed on your system is the version that is released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then the window title will still be identified only with matching letter case (case-sensitive) by default. For example, you can enter the String value as `((\w)-Notepad` for all the window title names starting with `((\w)-Notepad`, or use Pattern such as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. Ensure that when you add the string input as `-title`, the application with the specific title is open. `` is just a character and not a wild card character. When you use a regular expression of type Pattern with -title as the input value for a window title in any action, the bot might encounter a run time error since the input value `-title` is incorrect. Ensure that you use valid regex patterns. All browsers: Closes all open browser windows for supported browsers. Optional: In the Time out after field, enter the number of seconds the bot must wait for the browser window or tab to close before the bot fails. Recommended: Enter a timeout value of at least 9 seconds.
Download files	Downloads and saves files from specified URLs and URLs that require NTLM authentication. Specify the URL of the file you want to download. In the Save to location field, enter the location where you want to save the file.
Find broken links	See Using Find broken links action.
Get source code	Retrieves the source code of an entire web page and an iFrame on a web page and saves the output to a string variable. Note: This action supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Select the browser tab from the list of active supported browser tabs or insert a window variable. Optional: Use the Capture object option to capture the iFrames. Note: The Capture object feature is used only to retrieve the source code of an iFrame. If you do not capture anything on the window, the source code of the entire window is retrieved. Retrieving the source code of an iFrame is currently supported only on the Google Chrome browser. Optional: In the Time out after field, enter the number of seconds the bot must wait for the browser window or tab to close before the bot fails. Recommended: Enter a timeout value of at least 9 seconds. Optional: Select a variable to hold the action output. The Control Room shows a descriptive default variable name. If you create several output variables, subsequent variable names are appended with a -1, -2, -3, and so on to avoid duplication.
Go back	Returns to a web page that you previously visited in the current tab. This action simulates clicking the browser Back option. Note: This action supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Select the browser tab from the list of active supported browser tabs or insert a window variable. Note: When you select the Internet Explorer tab from the list of active tabs, and if the selected tab title or any intermediate tab title while performing the Go back action has more than 60 characters, then the first 60 characters are used for comparison to find the matching tab title. Recommendation: When you perform the action on the browser tab, ensure that only a single tab is open in the browser window with the matching tab title. This setting ensures that when the action is executed, there is no intermediate tab title that matches another tab title in the same window. In the Number of steps back field, enter the number of pages to go back to. Optional: Select the Throw an error if steps exceed history option so that the bot will fail if the number entered in the previous step is greater than the number of pages visited. If this option is not selected, when the bot runs, it will return the tab to the first web page it opened. Optional: In the Time out after field, enter the number of seconds the bot must wait for the browser window or tab to close before the bot fails. Recommended: Enter a timeout value of at least 9 seconds.
Open	Opens the browser to a specific web page. Select to open the web page in an existing tab, new tab, or new window: Existing tab: Opens the web page on a currently open tab. Select the tab from the list of active supported browser tabs, the Last used browser tab option, or insert a window variable. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. You can use a regular expression (regex) to identify a window title. Select the regular expression either as a String or Pattern for each regular expression condition and enter the value. By default, the Window title field is case-sensitive. You can enable Case insensitive regex flag to identify a window title that is not case-sensitive. To identify a static window or browser title and a title with a wildcard character, enable the Case sensitive option if you want the letter case to match. Disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum version of the Bot Agent installed on your system is the version that is released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then the window title will still be identified only with matching letter case (case-sensitive) by default. For example, you can enter the String value as `((\w)-Notepad` for all the window title names starting with `((\w)-Notepad`, or use Pattern such as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. Ensure that when you add the string input as `-title`, the application with the specific title is open. `` is just a character and not a wild card character. When you use a regular expression of type Pattern with -title as the input value for a window title in any action, the bot might encounter a run time error since the input value `-title` is incorrect. Ensure that you use valid regex patterns. New tab: Opens the web page on a new tab. Select the tab from the list of active supported browser tabs or insert a window variable. Note: This option supports Google Chrome, Chromium-based Microsoft Edge, and the Internet Explorer browsers. When you perform the action on the Internet Explorer tab, the action is executed in the matching tab only when it is in ready state. You can use a regular expression (regex) to identify a window title. Select the regular expression either as a String or Pattern for each regular expression condition and enter the value. By default, the Window title field is case-sensitive. You can enable Case insensitive regex flag to identify a window title that is not case-sensitive. To identify a static window or browser title and a title with a wildcard character, enable the Case sensitive option if you want the letter case to match. Disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum version of the Bot Agent installed on your system is the version that is released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then the window title will still be identified only with matching letter case (case-sensitive) by default. For example, you can enter the String value as `((\w)-Notepad` for all the window title names starting with `((\w)-Notepad`, or use Pattern such as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. Ensure that when you add the string input as `-title`, the application with the specific title is open. `` is just a character and not a wild card character. When you use a regular expression of type Pattern with -title as the input value for a window title in any action, the bot might encounter a run time error since the input value `-title` is incorrect. Ensure that you use valid regex patterns. New window: Opens the web page on a new window of a specific browser. Select the browser from the following options: Default Browser Ensure that Google Chrome, Microsoft Edge or Internet Explorer is set as the default browser. Note: If any browser that is not listed is set as the default browser for the device, the bot might encounter an error. Google Chrome Internet Explorer Microsoft Edge Mozilla Firefox Enter the link to the web page to open. Note: For web pages to open properly, we recommend that you specify a URL with the protocol information, such as http, https, or file. Optional: In the Time out after field, enter the number of seconds the bot must wait for the specified webpage to load before the bot fails. Recommended: Enter a timeout value of at least 9 seconds. Note: Timeout is applicable only for the New tab and Existing tab options. For the Internet Explorer browser, the bot executes even if the webpage is not loaded completely after waiting till timeout.
Run JavaScript	Executes JavaScript on a web page and on web pages that have iFrames. Note: This action supports Google Chrome, Chromium-based Microsoft Edge, and Internet Explorer browsers. Select the browser tab from the list of active supported browser tabs or insert a window variable. You can use a regular expression (regex) to identify a window title. Select the regular expression either as a String or Pattern for each regular expression condition and enter the value. By default, the Window title field is case-sensitive. You can enable Case insensitive regex flag to identify a window title that is not case-sensitive. To identify a static window or browser title and a title with a wildcard character, enable the Case sensitive option if you want the letter case to match. Disable the option to identify a window title where the letter case does not match. Note: Ensure that the minimum version of the Bot Agent installed on your system is the version that is released with Automation 360 v.26. If you have a Bot Agent version released with Automation 360 v.25 or earlier, then the window title will still be identified only with matching letter case (case-sensitive) by default. For example, you can enter the String value as `((\w)-Notepad` for all the window title names starting with `((\w)-Notepad`, or use Pattern such as `((\w)\s)document-Notepad` for only those window titles that match this pattern. Note: When you use a regular expression of type String with `-title` as the input value for a window title in any action, the bot might encounter a run time error. Ensure that when you add the string input as `-title`, the application with the specific title is open. `` is just a character and not a wild card character. When you use a regular expression of type Pattern with -title as the input value for a window title in any action, the bot might encounter a run time error since the input value `-title` is incorrect. Ensure that you use valid regex patterns. Choose one of the following options: In the Import existing file option, select an existing JavaScript file. Note: If you are uploading a script from a file on your desktop, the file and any dependencies must be in a standalone folder. When you select a file for upload, all files and folders at the same folder level are uploaded. In the Manual input option, enter the JavaScript. Optional: Use the Capture object option to capture the iFrames. Note: The Capture object feature is used only to run JavaScript inside an iFrame. Support to run JavaScript inside an iFrame is available only for the Google Chrome browser. Optional: In the Time out after field, enter the number of seconds the bot must wait for the browser window or tab to close before the bot fails. Recommended: Enter a timeout value of at least 9 seconds. Optional: Select a variable to hold the action output. The Control Room shows a descriptive default variable name. If you create several output variables, subsequent variable names are appended with a -1, -2, -3, and so on to avoid duplication. Recommendation: Do not use Jquery with the JavaScript package. Use the Try/Catch actions from the Error handler in the JavaScript function. Call a JavaScript function before declaring it.

Note:

When you perform any action from the Browser package on the Internet Explorer browser tab, if multiple tabs with the same tab title are opened in the same browser window, the matching title is not searched in sequence starting from the first tab. The tab activation and browser action might be performed on different matching tabs in sthis case.
If the same tab title occurs on different windows, then the action is executed on a tab with a matching title in any window.

Automation 360