---
name: browser-e2e-tester
description: Browser-based E2E testing for feature verification. Use when running end-to-end tests, validating features in browser, verifying user flows, or testing feature completion.
version: 1.0.0
category: autonomous-coding
layer: verification-recovery
---

# Browser E2E Tester

Runs browser-based end-to-end tests to verify feature implementation meets acceptance criteria.

## Quick Start

### Run Feature Tests
```python
from scripts.e2e_tester import E2ETester

tester = E2ETester(project_dir)
result = await tester.test_feature("auth-001")

if result.passed:
    print(f"Feature verified: {result.feature_id}")
else:
    print(f"Failed: {result.failures}")
```

### Run All Tests
```python
results = await tester.test_all_features()
print(f"Passed: {results.passed}/{results.total}")
```

## E2E Testing Workflow

```
┌─────────────────────────────────────────────────────────────┐
│                    E2E TEST WORKFLOW                        │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. SETUP                                                   │
│     ├─ Load feature acceptance criteria                    │
│     ├─ Start test server (if needed)                       │
│     ├─ Initialize browser automation                       │
│     └─ Set test timeout                                    │
│                                                             │
│  2. EXECUTE                                                 │
│     ├─ Navigate to feature entry point                     │
│     ├─ Execute test steps                                  │
│     ├─ Capture screenshots on failure                      │
│     └─ Record test artifacts                               │
│                                                             │
│  3. VERIFY                                                  │
│     ├─ Check expected outcomes                             │
│     ├─ Validate UI state                                   │
│     ├─ Verify API responses                                │
│     └─ Assert data persistence                             │
│                                                             │
│  4. REPORT                                                  │
│     ├─ Generate test report                                │
│     ├─ Update feature status                               │
│     └─ Store failure artifacts                             │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

## Test Result Structure

```python
@dataclass
class TestResult:
    feature_id: str
    passed: bool
    duration_ms: int
    steps_executed: int
    steps_passed: int
    failures: list[str]
    screenshots: list[Path]
    artifacts: dict
```

## Supported Test Frameworks

| Framework | Integration | Use Case |
|-----------|-------------|----------|
| **Playwright** | Native | Modern web apps |
| **Puppeteer** | Adapter | Chrome-focused |
| **Selenium** | Adapter | Legacy browsers |
| **Cypress** | CLI | Component tests |

## Feature Acceptance Format

```json
{
  "feature_id": "auth-001",
  "acceptance_criteria": [
    {
      "step": "Navigate to login page",
      "action": "goto",
      "target": "/login"
    },
    {
      "step": "Enter credentials",
      "action": "fill",
      "target": "#email",
      "value": "test@example.com"
    },
    {
      "step": "Submit form",
      "action": "click",
      "target": "button[type=submit]"
    },
    {
      "step": "Verify redirect",
      "action": "assert_url",
      "expected": "/dashboard"
    }
  ]
}
```

## Integration Points

- **coding-agent**: Triggers tests after implementation
- **progress-tracker**: Reports test metrics
- **error-recoverer**: Handles test failures
- **checkpoint-manager**: Restores state on failure

## References

- `references/E2E-PATTERNS.md` - Test patterns
- `references/BROWSER-AUTOMATION.md` - Automation guide

## Scripts

- `scripts/e2e_tester.py` - Core tester
- `scripts/browser_controller.py` - Browser automation
- `scripts/test_reporter.py` - Report generation
- `scripts/acceptance_parser.py` - Criteria parser