chore: import upstream snapshot with attribution

2026-07-13 13:24:08 +08:00
commit 0d3cb498a3
5438 changed files with 1316560 additions and 0 deletions
@@ -0,0 +1,79 @@
+# 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 playwright @playwright/browser-chromium playwright-extra puppeteer-extra-plugin-stealth
+```
+
+## Files
+
+- `promptfooconfig.yaml` - Example configuration showing both modes
+- `server.js` - Test web server
+- `test-page.html` - Mock authenticated chat interface