Browser state & emulation
bl emulate
Emulate the browsing environment (locale, timezone, user agent, network, scripting)
Emulate the browsing environment (locale, timezone, user agent, network, scripting)
Usage
bl emulate [OPTIONS]
bl emulate <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 emulate environment
Set session-scoped environment overrides (persist until reset)
Usage
bl emulate environment [OPTIONS]Options
| Option | Description |
|---|---|
--locale <value> | BCP 47 language tag, e.g. fr-CA |
--timezone <value> | IANA zone (Asia/Tokyo) or offset (+05:30) |
--user-agent <value> | User-Agent string |
--offline | Emulate being offline |
--no-scripting | Emulate disabled JavaScript for page content |
--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 emulate environment --locale fr-CA
# Browse as a French-Canadian locale
bl emulate environment --timezone Asia/Tokyo --locale ja-JP
# Combine environment overrides
bl emulate environment --offline
# Take the session offlinebl emulate reset
Reset environment overrides to the browser defaults
Usage
bl emulate reset <target> [OPTIONS]Arguments
| Argument | Description |
|---|---|
<target> | Which override to reset ('environment' resets all five) |
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 emulate reset locale
# Restore the real locale
bl emulate reset environment
# Restore everything