Setup
bl is
Check element state (visible, enabled, checked, actionable)
Check element state (visible, enabled, checked, actionable)
Usage
bl is [OPTIONS]
bl is <command>Options
| Option | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
bl is visible
Check if an element is visible on the page
Usage
bl is visible <selector> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<selector> | CSS selector of the element to check |
Options
| Option | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl is visible "h1"
# Prints true or falsebl is enabled
Check if an element is enabled
Usage
bl is enabled <selector> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<selector> | CSS selector of the element to check |
Options
| Option | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl is enabled "button[type=submit]"
# Prints true or falsebl is checked
Check if a checkbox or radio is checked
Usage
bl is checked <selector> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<selector> | CSS selector of the checkbox or radio to check |
Options
| Option | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl is checked "input[type=checkbox]"
# Prints true or falsebl is actionable
Check actionability of an element (Visible, Stable, ReceivesEvents, Enabled, Editable)
Usage
bl is actionable <url> <selector> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<url> | URL to navigate to before checking |
<selector> | CSS selector of the element to check |
Options
| Option | Description |
|---|---|
--headless | Hide browser window (visible by default) |
--json | Output as JSON |
--session <value> | Run this command in the named session (env: BL_SESSION; default: "default") |
Global options
| Option | Description |
|---|---|
-v, --verbose | Enable debug logging |
Examples
bl is actionable https://example.com "a"
# Output:
# Checking actionability for selector: a
# ✓ Visible: true
# ✓ Stable: true
# ✓ ReceivesEvents: true
# ✓ Enabled: true
# ✗ Editable: false