bdg dom click

​

Overview

​

Syntax

bdg dom click <selector> [options]

​

Arguments

​

Options

​

Behavior

​

Event dispatch

• Dispatches React-compatible synthetic events: mousedown, mouseup, click
• Works with both native DOM elements and React components
• Properly triggers React event handlers (onClick, etc.)

​

Automatic waiting

• Network idle (no requests for 150ms)
• DOM stable (no mutations for 200ms)
• Maximum wait: 2 seconds

​

Examples

​

Click by selector

# By ID
bdg dom click "#login-btn"

# By class
bdg dom click ".submit-button"

# By attribute
bdg dom click "button[type='submit']"

​

Click by cached index

# Step 1: Query and cache
bdg dom query "button"
# Found 3 elements:
# [0] <button.primary> "Submit"
# [1] <button.secondary> "Cancel"
# [2] <button.link> "Learn more"

# Step 2: Click by index
bdg dom click 0  # Click Submit
bdg dom click 1  # Click Cancel

​

Click specific match

# Click 2nd button (0-based indexing)
bdg dom click "button" --index 1

​

Skip stability wait

# For fast, non-navigating clicks
bdg dom click "#fast-btn" --no-wait

​

Common workflows

​

Form submission

# Fill form and submit
bdg dom fill "#email" "[email protected]"
bdg dom fill "#password" "SecurePass123"
bdg dom click "button[type='submit']"
# Automatically waits for page response

​

Multi-step navigation

# Query tabs
bdg dom query ".tab"
# [0] <div.tab> "Overview"
# [1] <div.tab> "Details"
# [2] <div.tab> "History"

# Click second tab
bdg dom click 1
# Waits for tab content to load

​

Toggle states

# Toggle checkbox
bdg dom click "#terms-checkbox"

# Open dropdown
bdg dom click ".dropdown-trigger"

​

Exit codes

​

Comparison with other click methods

​

Troubleshooting

​

Element not clickable

1. Scroll element into view first: bdg dom scroll <selector>
2. Check element exists: bdg dom query <selector>
3. Verify element is not disabled: bdg dom get <selector>

​

Click doesn’t trigger action

• Use bdg dom pressKey <selector> Enter for keyboard submission
• Use bdg dom submit for form submissions with navigation

​

Slow response

• Use --no-wait for clicks that don’t trigger network activity
• Adjust network idle threshold (currently 150ms)

​

Related commands

• bdg dom fill - Fill form fields
• bdg dom submit - Submit forms with navigation wait
• bdg dom query - Find elements to click
• bdg dom scroll - Scroll element into view