Skip to main content
Go to the Studio
Browser

Open New Tab

Open New Tab

Opens a new tab in a browser that is already running, goes to the URL you give it, and returns a reference to the new page for the actions that follow.


Options​

Browser or page ID​

The browser the new tab opens in. Left empty, a new browser starts automatically.

Initial URL​

The web address loaded in the new tab.

Loading type​

What counts as the new page having finished loading:

  • networkidle — waits until there have been no active network requests for 500ms (the default)
  • domcontentloaded — waits only for the HTML
  • load — waits for every one of the page's resources

Timeout​

How long, in milliseconds, the action waits for the page to load before raising an error. The default is 30000. Use 0 for no limit.

Returns​

Javascript code​

js
actions["action-id"]._page     // the new tab's active page (Session)
actions["action-id"]._browser  // the new tab's browser instance (Session)

Field selection​

_page and _browser are available in the Browser or page ID field of every other browser action.

Rules and conditions​

  • With Browser or page ID left empty, the action opens a new browser with the default settings before creating the tab.
  • If the page does not load within the timeout, the action ends in an error.
  • In a browser opened in incognito mode, the new tab is created inside the same private browsing context.