DocsWait Utilitiesbrowser_wait_for_download

browser_wait_for_download

Browser Wait For Download

Block until a specific download completes or times out. Returns the final download status and file path on success. Use after triggering a download to ensure it finishes before proceeding.

Usage Example

1234567891011
import asyncio
from owl_browser import OwlBrowser, RemoteConfig
# Async usage
async with OwlBrowser(config) as browser:
context = await browser.create_context()
context_id = context["context_id"]
await browser.wait_for_download(
download_id="value"
)

Parameters

Required

download_idstringrequired

The unique identifier of the download to wait for, obtained from browser_get_downloads or triggered download events

Optional

timeoutstring

Maximum time to wait for download completion in milliseconds. Returns error if exceeded. Default: 30000 (30 seconds). Set higher for large files

Response

Returns a JSON object with the operation result.

{
  "success": true,
  "result": <value>
}