browserlane
Guides

Dialogs & downloads

Handle native alert/confirm/prompt dialogs and control where downloaded files land.

Two things that trip up automation on real sites: native browser dialogs (alert, confirm, prompt) that block the page until answered, and downloads that need to land somewhere predictable. browserlane has a command for each.

Dialogs: accept or dismiss

A native dialog — the browser's own alert, confirm, or prompt box — pauses the page until it's handled. Use bl dialog to answer it:

bl dialog accept          # accept (OK / Yes)
bl dialog dismiss         # dismiss (Cancel / No)

For a prompt that asks for text, pass the answer to accept:

bl dialog accept "my answer"

A typical flow is: trigger the action that raises the dialog, then answer it. For example, a "Delete" button that pops a confirm:

bl map
bl click @e3              # this raises a confirm dialog
bl dialog accept          # confirm the deletion
bl diff map               # verify the row is gone

Confirm vs prompt vs alert

accept confirms an alert/confirm (and submits text for a prompt when you pass it); dismiss cancels. An alert has only one button, so accept and dismiss both just clear it.

Downloads: set the directory

When a click triggers a file download, point the browser at a directory first so you know where the file lands:

bl download dir ./downloads
bl click @e5             # click the download link

After that, the downloaded file appears in ./downloads. Set the directory once per session before the download happens.

# Full example: navigate, set the target dir, trigger the download
bl go https://example.com/reports
bl download dir ./downloads
bl find text "Export CSV"   # → @e1
bl click @e1

Set the directory before downloading

bl download dir configures where subsequent downloads go, so set it before the click that starts the download — not after.

On this page