Elements

bl click

Click an element (optionally navigate to URL first)

Click an element (optionally navigate to URL first)

Usage

bl click <args...> [OPTIONS]

Arguments

ArgumentDescription
&lt;args...&gt;[url] selector — optional URL to navigate first, then the selector to click

Options

OptionDescription
--timeout <value>Timeout for actionability checks (e.g., 5s, 30s) (default 30s)
--nth <value>Select the 0-based Nth match of the selector (default: first). Mutually exclusive with --last.
--lastSelect the last match of the selector. Mutually exclusive with --nth.
--headlessHide browser window (visible by default)
--jsonOutput as JSON
--session <value>Run this command in the named session (env: BL_SESSION; default: "default")

Global options

OptionDescription
-v, --verboseEnable debug logging

Examples

bl click "a"
# Clicks on current page

bl click ".row" --nth 2
# Click the third matching row (0-based)

bl click ".row" --last
# Click the last matching row

bl click https://example.com "a"
# Navigates to URL first, then clicks

bl click https://example.com "a" --timeout 5s
# Custom timeout for actionability checks

On this page