Read and Review Automation Anywhere Documentation

Automation 360

Close Contents

Contents

Open Contents

Browser package

  • Updated: 2022/05/11
    • Automation 360 v.x
    • Build
    • RPA Workspace

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.

      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.

    • 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.

      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.

    • 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.
  • 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 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.
Launch website Launches the browser.
  • In the URL field, specify the website you want to open.
  • Select your browser from the following:
    • Default Browser
    • Google Chrome
    • Microsoft Edge
    • Internet Explorer

    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. When actions such as OCR and Image Recognition are used, the browser must finish rendering before Microsoft Edge execute.
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.

      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.

    • 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.

      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.

    • 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.
  • 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.

    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.

  • 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.
Send Feedback