electron-e2e-testing

Electron E2E Testing with electron-dev-bridge

Structured test patterns using the MCP bridge. 41 tools available.

Test Pattern: Batch Execute + Assert

The fastest pattern — combine actions and verification in minimal calls:

# 1. Connect
electron_connect

# 2. Understand the page
electron_get_page_summary

# 3. Snapshot before action
electron_diff_state  mode="snapshot"

# 4. Execute steps in one call
electron_execute_steps  steps=[
  {"wait": "[data-testid='form']"},
  {"fill": {"selector": "#email", "text": "[email protected]"}},
  {"fill": {"selector": "#name", "text": "Jane Doe"}},
  {"click": "[type='submit']"},
  {"wait": ".success-message"},
  {"screenshot": true}
]

# 5. Assert results
electron_assert  assertions=[
  {"selector": ".success-message", "text": "Saved"},
  {"selector": "#email", "value": "[email protected]"},
  {"url": "/dashboard"}
]

# 6. Check what changed
electron_diff_state  mode="diff"

Playbook: Form Fill & Submit

# 1. Discover form structure
electron_get_form_state  selector="form"

# 2. Fill all fields in one batch
electron_execute_steps  steps=[
  {"fill": {"selector": "#name", "text": "Jane Doe"}},
  {"fill": {"selector": "#email", "text": "[email protected]"}},
  {"click": "[type='submit']"}
]

# 3. Wait for response
electron_wait_for_network_idle  idleTime=500

# 4. Assert
electron_assert  assertions=[
  {"selector": ".success", "text": "submitted"},
  {"selector": ".error", "exists": false}
]

Playbook: Visual Regression

# Phase 1: Capture baseline
electron_connect
electron_wait_for_selector  selector="{YOUR_APP_ROOT}"
electron_screenshot
# Note the returned file path as baseline

# Phase 2: After code changes, restart
electron_launch  appPath="/path/to/{YOUR_APP}"
electron_wait_for_selector  selector="{YOUR_APP_ROOT}"
electron_screenshot
# Note the returned file path as current

# Phase 3: Compare
electron_compare_screenshots  pathA="baseline.png"  pathB="current.png"
# Returns: { identical: false, diffPercent: 0.5, totalBytes: 120000, diffBytes: 600 }