WebRunner English Documentation
The English manual is split into chapters that follow a typical reader journey: install → drive a browser → author actions → scale → integrate. Use the table of contents on the left, or jump straight to a chapter below.
Chapter 1 — Getting Started
Install WebRunner, run your first browser session, and scaffold a new project skeleton.
Getting Started
Chapter 2 — Core Wrappers
The Selenium-facing facade: drivers, options, elements, and locator value objects. Read this once and the rest of the framework stops feeling like magic.
Core Wrappers
- Architecture
- WebDriver Wrapper
- Overview
- Navigation
- Element Finding
- Wait Methods
- Mouse Actions
- Keyboard Actions
- Action Chain Control
- Cookie Management
- JavaScript Execution
- Window Management
- Screenshots
- Frame / Window / Alert Switching
- Browser Logs
- WebDriver Validation
- Advanced Launch Options
- Page / Window Metadata
- Page Reload / Scroll / Foreground
- Screenshots & PDF
- Session Persistence
- CDP Shortcuts (Chromium only)
- CDP Fetch Interception
- W3C BiDi Event Listeners
- Standalone CDP / BiDi Modules
- Action JSON Aliases
- Internal Mixin Layout
- WebDriver Manager
- WebDriver Options Configuration
- Web Element Wrapper
- Test Object
Chapter 4 — Browser Backends
Selenium and Playwright back-ends, plus the lower-level browser glue (CDP / DevTools, capabilities, network shaping).
Chapter 5 — Reporting & Observability
Generate HTML / JSON / XML reports, ship logs, surface metrics, and diff trends across runs.
Reporting
Chapter 6 — Orchestration & Scale
Parallel runs, sharding, retries, Selenium Grid, and Kubernetes Job manifests.
Chapter 7 — Quality, Security & Data
Linting, locator scoring, PII redaction, accessibility diffs, contract testing, and data / auth helpers.
Quality & Data
- Quality & security
- Test data
- Specialized Modules
- Web Platform APIs
- Security & Headers
- Performance Budgets
- Backend Integration
- AI / Workflow
- a11y / i18n / Visual
- Governance & Reporting
- Other Specialised Modules
- Modern web platform & runtime APIs
- Modern auth, payments, identity
- Mobile-web specific
- LLM / AI feature testing
- Email & notification delivery
- Performance budgets (cont.)
- Security & headers (cont.)
- Backend integration (cont.)
- QA governance & DevX (cont.)
- i18n / a11y (cont.)
- Emerging-tech device APIs
- Where to look next
Chapter 8 — Tooling, CLI & Diagnostics
Command-line entry points, the remote socket driver, and the exception hierarchy you will see in tracebacks.
Chapter 9 — Integrations
CI annotations, JIRA / TestRail / Slack notifiers, IDE schema mappings, and the Model Context Protocol (MCP) server that lets Claude drive WebRunner.
Chapter 10 — API Reference
Auto-generated Python API reference and the legacy “extended features” hub, kept for cross-linking from older guides.
Reference
- API reference
- je_web_runner.api.authoring
- je_web_runner.api.debugging
- je_web_runner.api.frontend
- je_web_runner.api.infra
- je_web_runner.api.mobile
- je_web_runner.api.networking
- je_web_runner.api.observability
- je_web_runner.api.quality
- je_web_runner.api.reliability
- je_web_runner.api.security
- je_web_runner.api.test_data
- je_web_runner.mcp_server
- je_web_runner.action_lsp
- Extended features