Skip to main content

Open Browser

Opens a new browser session for web automation. This is the starting point for all web automation workflows.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing the node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If Continue On Error property is true, no error is caught when the project is executed, even if the Catch node is used.

Output​

  • Browser ID - Unique identifier for the browser session. Use this ID with all other web automation nodes to interact with this browser instance.

Options​

  • Browser Type - Select the browser to use:

    • Chrome - Standard Google Chrome browser
    • Headless Chrome - Chrome without UI (for servers)
    • Firefox - Standard Mozilla Firefox browser
    • Headless Firefox - Firefox without UI (for servers)
    • Edge - Microsoft Edge browser
    • Internet Explorer - Legacy IE browser
    • Brave - Privacy-focused Brave browser (requires Browser Path)
    • Opera - Opera browser
    • Incogniton - Anti-detect browser (requires Browser Options)

  • Maximized - Start the browser window maximized. Default is true.

  • Full Screen - Start the browser in full screen mode. Default is false.

  • Proxy Settings - Configure proxy connection:

    • No Proxy - Direct connection (default)
    • Manual Proxy - Use custom proxy server (Chrome only)

  • Proxy Address - Proxy server address in format host:port (e.g., proxy.example.com:8080). Required when Manual Proxy is selected.

  • Proxy Authentication - Authentication method for proxy:

    • No Authentication - No proxy credentials required
    • Basic Authentication - Use username/password from Vault

  • Proxy Credentials - Vault credentials for proxy authentication. Required when Basic Authentication is selected.

  • Browser Path - Full path to browser executable. Required for Brave browser.

  • User Data Dir - Path to browser profile directory. Use this to persist browser data, cookies, and sessions between runs. Not supported in Firefox.

  • Download Dir - Default directory for file downloads. If empty, uses browser's default download folder.

  • Browser Options - Additional browser configuration options as JSON object. For Incogniton, requires:

    {
      "incogniton_profile_id": "xxx-xxx-xxx",
      "incogniton_port": 35000
    }

Examples​

Basic Chrome Browser​

Open a standard Chrome browser:

Browser Type: Chrome
Maximized: true

Headless Browser for Server​

Run browser without UI on a server:

Browser Type: Headless Chrome

Browser with Custom Profile​

Reuse an existing browser profile:

Browser Type: Chrome
User Data Dir: C:\Users\YourName\AppData\Local\Google\Chrome\User Data\Profile1

Browser with Proxy​

Use a proxy server with authentication:

Browser Type: Chrome
Proxy Settings: Manual Proxy
Proxy Address: proxy.example.com:8080
Proxy Authentication: Basic Authentication
Proxy Credentials: [Select from Vault]

Incogniton Anti-Detect Browser​

Browser Type: Incogniton
Browser Options:
{
  "incogniton_profile_id": "abc-123-def-456",
  "incogniton_port": 35000
}

Tips​

  • Always store the Browser ID output in a variable to use with other web automation nodes
  • Use Headless Chrome for automation running on servers without displays
  • Enable User Data Dir to persist login sessions between automation runs
  • For proxy authentication, store credentials securely in the Vault
  • Incogniton browser must be running before executing this node

Common Errors​

  • "Browser Type must be selected" - Select a browser from the dropdown
  • "Proxy is only supported for Chrome browser" - Change browser to Chrome/Headless Chrome or disable proxy
  • "Proxy Address cannot be empty" - Provide proxy address in host:port format
  • "Browser Path is required for Brave" - Specify the full path to Brave executable
  • "Firefox does not support custom user data directory" - Remove User Data Dir or switch to Chrome
  • "Cannot connect to Incogniton browser" - Ensure Incogniton application is running
  • "Browser Options must be a JSON object with incogniton_profile_id" - Provide valid JSON with required fields