Browser Open

​

Overview

• Opening browser sessions (Chrome, Firefox, etc.)
• Navigating to URLs
• Managing browser session state
• Configuring browser options
• Establishing persistent sessions across commands

​

Parameters

​

Usage Examples

​

Basic Browser Open

{
  "command": "browser-open",
  "params": {
    "url": "https://example.com"
  }
}

​

Browser Open with Session

{
  "command": "browser-open",
  "params": {
    "sessionId": "#{UUID}",
    "url": "https://example.com"
  }
}

​

Browser Open with Options

{
  "command": "browser-open",
  "params": {
    "url": "https://example.com",
    "browserType": "chrome",
    "options": {
      "headless": false,
      "viewport": {
        "width": 1920,
        "height": 1080
      }
    },
    "timeout": 30000
  }
}

​

Browser Open with Dynamic URL

{
  "command": "browser-open",
  "params": {
    "url": "https://example.com/page?id=@{PROJECT_ID}",
    "sessionId": "#{UUID}"
  }
}

​

Session Management

​

Creating a Session

{
  "command": "browser-open",
  "params": {
    "sessionId": "#{UUID}",
    "url": "https://example.com"
  }
}

​

Reusing a Session

{
  "command": "click",
  "params": {
    "sessionId": "#{UUID}",
    "selector": ".button"
  }
}

​

Variable Support

• URL: Use @{VARIABLE} in URLs
• Session ID: Use #{UUID} for session tracking

​

Common Variable Patterns

• Project Variables: @{PROJECT_ID}, @{RUN_ID} - Include in URLs
• Session Variables: #{UUID} - Maintain browser session state
• Dynamic URLs: Use variables to construct dynamic URLs

​

Browser Options

​

Common Options

• headless: Run browser in headless mode (default: false)
• viewport: Set browser viewport size
• userAgent: Set custom user agent string
• timeout: Set navigation timeout

​

Best Practices

• Use Session IDs: Leverage #{UUID} for maintaining browser state
• Set Appropriate Timeouts: Configure timeouts for page loading
• Handle Navigation Errors: Implement error handling for failed navigation
• Use HTTPS: Prefer HTTPS URLs for secure connections
• Configure Viewport: Set appropriate viewport size for consistent rendering

​

Common Use Cases

• Web Scraping: Open pages for content extraction
• Form Automation: Navigate to forms for automation
• Multi-Page Workflows: Establish sessions for multi-page navigation
• Dynamic Content: Handle JavaScript-rendered content

​

Related Commands

• Get Text Contents - Extract text after opening browser
• Get Attributes - Extract attributes after opening browser
• Interaction Commands - Interact with opened pages