Skip to main content

Configuring Browser Settings

Before using Web Agent, you need to configure the browser settings in PostQode to establish a connection with your browser for automation tasks.

Step-by-Step Setup

Step 1: Access PostQode Settings

  1. Open VS Code with PostQode extension installed
  2. Click on the PostQode icon in the sidebar to open the PostQode panel
  3. Click on the Settings icon (gear icon) in the PostQode panel

Step 2: Navigate to Browser Settings

  1. In the Settings panel, find Browser
  2. Click on Browser to see the configuration options

Step 3: Configure Remote Browser Connection

  1. Look for the "Use Remote Browser Connection" option
  2. Check the checkbox to enable remote browser connection
  3. If the connection is successful, you'll see a green indicator showing "Connected"
  4. If the connection fails, you'll see a red indicator showing "Disconnected"

Connection Status Indicators

StatusIndicatorDescription
Connected🟢 Green dotBrowser connection is active and ready
Disconnected🔴 Red dotBrowser connection failed or not configured
Connecting🟡 Yellow dotAttempting to establish connection

Troubleshooting Browser Connection

Common Issues and Solutions

Connection Failed

  • Check Internet Connection: Ensure you have a stable internet connection
  • Firewall Settings: Make sure PostQode is allowed through your firewall
  • Browser Permissions: Grant necessary permissions for browser automation

Slow Connection

  • Network Latency: Remote connections may have higher latency
  • Server Load: Remote browser services may be under heavy load
  • Local Resources: Check if your local machine has sufficient resources

Browser Not Responding

  • Restart Connection: Toggle the remote browser connection off and on
  • Clear Cache: Clear browser cache and cookies
  • Update Browser: Ensure your browser is up to date

Advanced Configuration

Browser Options

You can configure additional browser options:

  • Headless Mode: Run browser without GUI for faster execution
  • Browser Type: Choose between Chrome, Firefox, Safari, or Edge
  • Window Size: Set default browser window dimensions

Verifying Your Setup

After configuring browser settings:

  1. Check Connection Status: Ensure the indicator shows "Connected"
  2. Test Basic Navigation: Try navigating to a simple website
  3. Verify Screenshots: Confirm that screenshots are being captured
  4. Test Interactions: Try clicking a button or filling a form

Next Steps

Once your browser settings are configured:

  1. Switch to Web Agent Mode
  2. Start Your First Web Automation Task
  3. Learn About Generating Scripts