← Back to Browser
OpenClaw browser

Uploads, downloads, and dialogs

Use this page when the browser workflow needs to attach a file, claim a download, or clear a blocking confirmation prompt.

Core idea File flows are real workflow steps, not awkward edge cases around the “main” action.
File workflow model

Uploads, downloads, and dialogs need dedicated handling

Uploads, downloads, and confirmation dialogs carry timing and state that ordinary clicks and typing do not handle well by themselves.

Treat them as first-class workflow steps and verify their outcomes separately.

Most common moves

Use the right helper for the right file step

Upload

File input helper

Use the upload helper against the current file input ref instead of faking a text field.

Download

Claim the artifact

Own the next download intentionally when the exact saved file matters.

Prompt

Dialog handling

Treat a pending confirmation prompt as the real gate if the workflow freezes after a click.

Verification

Triggering the file flow is not enough

  • after upload, verify the page accepted the file
  • after download, verify where the file landed or what path was returned
  • after dialog acceptance, verify that the page advanced as expected
Next route

Where users usually go next