Skip to main content
Docs
Go to the Studio
Roberty Studio
RPABrowser

Open Browser

Open Browser

Opens a new browser instance and goes to the URL you give it, making the session available to the robot's other actions. This action's ID is what every later browser action refers back to.

caution

The browser you pick has to be installed on the machine the robot runs on. The supported browsers are Google Chrome and Microsoft Edge. See the Runner's installation requirements for more.


Options​

Select the browser​

Which browser the automation uses. The supported ones are Google Chrome and Microsoft Edge.

Home URL​

The web address the browser goes to when it opens.

Keep opened after robot execution?​

Whether the browser stays open after the robot finishes. Google Chrome only. Default: on.

Incognito mode?​

With this on, the browser opens in private browsing, saving no history, cookies or session data. Default: off.

Run the browser hidden?​

With this on, the browser runs in the background (headless), with no window shown while the robot runs. Default: off. On Linux machines with no graphical session, the browser runs hidden automatically when this option is off and Parameters is left empty.

Session name​

An optional identifier for the browser session. Give it a name and the robot can reuse the same session on later runs, so it does not have to sign in again.

Parameters​

An advanced field for passing extra startup arguments to the browser. Optional.

Returns​

This action has no return fields. The opened browser is available through this action's ID in the Browser or page ID field of the other browser actions.

Rules and conditions​

  • The browser you pick has to be installed on the machine the robot runs on. Its executable is found automatically on Windows, macOS and Linux, including Microsoft Edge and Chrome for Testing.
  • Before opening a new window, the action checks the browser's communication port (CDP). If a browser (Chrome, Chromium or Edge) is already open on that port, the action connects to it instead of opening another one.
  • If the configured port is taken by another program that is not a browser, the action automatically uses the next free port (up to 10 ports ahead). If they are all taken, the action ends in an error.
  • When a Session name is given, the port comes from that name. If it is taken by another program that is not a browser, the action ends in an error; pick another session name in that case.
  • If the reused browser is open with no tab, the action opens one before connecting.
  • Keep opened after robot execution? is available for Google Chrome only.
  • With no Session name given, the session is named automatically after the browser you picked.