# integration-browser/existing-session (Browser Existing Session)

Test OAuth-authenticated applications by connecting to existing Chrome browser sessions.

You can run this example with:

```bash
npx promptfoo@latest init --example integration-browser/existing-session
cd integration-browser/existing-session
```

## Overview

This example demonstrates two browser provider modes:

1. **Connecting to existing Chrome sessions** - For OAuth/SSO authenticated testing
2. **Launching new browsers** - Normal browser automation

## Quick Start

### 1. Start the test server

```bash
cd examples/integration-browser/existing-session
node server.js
```

### 2. For OAuth testing (existing session)

```bash
# Start Chrome with debugging
chrome --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-test

# Manually log into your application in that Chrome instance

# Run tests using the existing session
npx promptfoo eval --filter-providers existing-session
```

### 3. For normal browser testing

```bash
# Just run the tests (launches new browser)
npx promptfoo eval --filter-providers new-browser
```

## Configuration

The `promptfooconfig.yaml` includes both modes:

```yaml
providers:
  # Connect to existing session
  - id: browser
    label: existing-session
    config:
      connectOptions:
        debuggingPort: 9222
      # ... test steps

  # Launch new browser
  - id: browser
    label: new-browser
    config:
      headless: true
      # ... test steps
```

## Prerequisites

```bash
npm install promptfoo "playwright@^1.63.0" "playwright-extra@^4.3.6" "puppeteer-extra-plugin-stealth@^2.11.2"
npx playwright install chromium
```

## Files

- `promptfooconfig.yaml` - Example configuration showing both modes
- `server.js` - Test web server
- `test-page.html` - Mock authenticated chat interface