Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.
Python ai-agentsai-toolsbrowser-agentbrowser-automationbrowser-usecdpcloud-browsercomputer-useheadless-browserllmmcpplaywrightpythonremote-browserstealth-browserweb-automationweb-scraping
Allow override of timeouts from env variables
Andrei Gheorghec16726433cd6
diff --git a/browser_use/browser/events.py b/browser_use/browser/events.pyindex 24c80aee5..ffa9a00b4 100644--- a/browser_use/browser/events.py+++ b/browser_use/browser/events.py@@ -1,6 +1,7 @@"""Event definitions for browser communication."""import inspect+import osfrom typing import Any, Literalfrom bubus import BaseEvent@@ -88,7 +89,7 @@ class NavigateToUrlEvent(BaseEvent[None]):# existing_tab: PageHandle | None = None # TODO# time limits enforced by bubus, not exposed to LLM:- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_NavigateToUrlEvent', '15.0')) # secondsclass ClickElementEvent(ElementSelectedEvent[dict[str, Any] | None]):@@ -103,7 +104,7 @@ class ClickElementEvent(ElementSelectedEvent[dict[str, Any] | None]):# click_count: int = 1 # TODO# expect_download: bool = False # moved to downloads_watchdog.py- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_ClickElementEvent', '15.0')) # secondsclass TypeTextEvent(ElementSelectedEvent[dict | None]):@@ -113,7 +114,7 @@ class TypeTextEvent(ElementSelectedEvent[dict | None]):text: strclear_existing: bool = True- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_TypeTextEvent', '15.0')) # secondsclass ScrollEvent(ElementSelectedEvent[None]):@@ -123,7 +124,7 @@ class ScrollEvent(ElementSelectedEvent[None]):amount: int # pixelsnode: 'EnhancedDOMTreeNode | None' = None # None means scroll page- event_timeout: float | None = 8.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_ScrollEvent', '8.0')) # secondsclass SwitchTabEvent(BaseEvent[TargetID]):@@ -131,7 +132,7 @@ class SwitchTabEvent(BaseEvent[TargetID]):target_id: TargetID | None = Field(default=None, description='None means switch to the most recently opened tab')- event_timeout: float | None = 10.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_SwitchTabEvent', '10.0')) # secondsclass CloseTabEvent(BaseEvent[None]):@@ -139,7 +140,7 @@ class CloseTabEvent(BaseEvent[None]):target_id: TargetID- event_timeout: float | None = 10.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_CloseTabEvent', '10.0')) # secondsclass ScreenshotEvent(BaseEvent[str]):@@ -148,7 +149,7 @@ class ScreenshotEvent(BaseEvent[str]):full_page: bool = Falseclip: dict[str, float] | None = None # {x, y, width, height}- event_timeout: float | None = 8.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_ScreenshotEvent', '8.0')) # secondsclass BrowserStateRequestEvent(BaseEvent[BrowserStateSummary]):@@ -159,7 +160,7 @@ class BrowserStateRequestEvent(BaseEvent[BrowserStateSummary]):cache_clickable_elements_hashes: bool = Trueinclude_recent_events: bool = False- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserStateRequestEvent', '30.0')) # seconds# class WaitForConditionEvent(BaseEvent):@@ -174,19 +175,19 @@ class BrowserStateRequestEvent(BaseEvent[BrowserStateSummary]):class GoBackEvent(BaseEvent[None]):"""Navigate back in browser history."""- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_GoBackEvent', '15.0')) # secondsclass GoForwardEvent(BaseEvent[None]):"""Navigate forward in browser history."""- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_GoForwardEvent', '15.0')) # secondsclass RefreshEvent(BaseEvent[None]):"""Refresh/reload the current page."""- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_RefreshEvent', '15.0')) # secondsclass WaitEvent(BaseEvent[None]):@@ -195,7 +196,7 @@ class WaitEvent(BaseEvent[None]):seconds: float = 3.0max_seconds: float = 10.0 # Safety cap- event_timeout: float | None = 60.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_WaitEvent', '60.0')) # secondsclass SendKeysEvent(BaseEvent[None]):@@ -203,7 +204,7 @@ class SendKeysEvent(BaseEvent[None]):keys: str # e.g., "ctrl+a", "cmd+c", "Enter"- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_SendKeysEvent', '15.0')) # secondsclass UploadFileEvent(ElementSelectedEvent[None]):@@ -212,7 +213,7 @@ class UploadFileEvent(ElementSelectedEvent[None]):node: 'EnhancedDOMTreeNode'file_path: str- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_UploadFileEvent', '30.0')) # secondsclass GetDropdownOptionsEvent(ElementSelectedEvent[dict[str, str]]):@@ -222,9 +223,12 @@ class GetDropdownOptionsEvent(ElementSelectedEvent[dict[str, str]]):node: 'EnhancedDOMTreeNode'- event_timeout: float | None = (- 15.0 # some dropdowns lazy-load the list of options on first interaction, so we need to wait for them to load (e.g. table filter lists can have thousands of options)- )+ event_timeout: float | None = float(+ os.getenv(+ 'TIMEOUT_GetDropdownOptionsEvent',+ '15.0',+ )+ ) # some dropdowns lazy-load the list of options on first interaction, so we need to wait for them to load (e.g. table filter lists can have thousands of options)class SelectDropdownOptionEvent(ElementSelectedEvent[dict[str, str]]):@@ -235,7 +239,7 @@ class SelectDropdownOptionEvent(ElementSelectedEvent[dict[str, str]]):node: 'EnhancedDOMTreeNode'text: str # The option text to select- event_timeout: float | None = 8.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_SelectDropdownOptionEvent', '8.0')) # secondsclass ScrollToTextEvent(BaseEvent[None]):@@ -244,7 +248,7 @@ class ScrollToTextEvent(BaseEvent[None]):text: strdirection: Literal['up', 'down'] = 'down'- event_timeout: float | None = 15.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_ScrollToTextEvent', '15.0')) # seconds# ============================================================================@@ -256,7 +260,7 @@ class BrowserStartEvent(BaseEvent):cdp_url: str | None = Nonelaunch_options: dict[str, Any] = Field(default_factory=dict)- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserStartEvent', '30.0')) # secondsclass BrowserStopEvent(BaseEvent):@@ -264,7 +268,7 @@ class BrowserStopEvent(BaseEvent):force: bool = False- event_timeout: float | None = 45.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserStopEvent', '45.0')) # secondsclass BrowserLaunchResult(BaseModel):@@ -279,13 +283,13 @@ class BrowserLaunchEvent(BaseEvent[BrowserLaunchResult]):# TODO: add executable_path, proxy settings, preferences, extra launch args, etc.- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserLaunchEvent', '30.0')) # secondsclass BrowserKillEvent(BaseEvent):"""Kill local browser subprocess."""- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserKillEvent', '30.0')) # seconds# TODO: replace all Runtime.evaluate() calls with this event@@ -338,7 +342,7 @@ class BrowserConnectedEvent(BaseEvent):cdp_url: str- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserConnectedEvent', '30.0')) # secondsclass BrowserStoppedEvent(BaseEvent):@@ -346,7 +350,7 @@ class BrowserStoppedEvent(BaseEvent):reason: str | None = None- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserStoppedEvent', '30.0')) # secondsclass TabCreatedEvent(BaseEvent):@@ -355,7 +359,7 @@ class TabCreatedEvent(BaseEvent):target_id: TargetIDurl: str- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_TabCreatedEvent', '30.0')) # secondsclass TabClosedEvent(BaseEvent):@@ -367,7 +371,7 @@ class TabClosedEvent(BaseEvent):# new_focus_target_id: int | None = None# new_focus_url: str | None = None- event_timeout: float | None = 10.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_TabClosedEvent', '10.0')) # seconds# TODO: emit this when DOM changes significantly, inner frame navigates, form submits, history.pushState(), etc.@@ -384,7 +388,7 @@ class AgentFocusChangedEvent(BaseEvent):target_id: TargetIDurl: str- event_timeout: float | None = 10.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_AgentFocusChangedEvent', '10.0')) # secondsclass TargetCrashedEvent(BaseEvent):@@ -393,7 +397,7 @@ class TargetCrashedEvent(BaseEvent):target_id: TargetIDerror: str- event_timeout: float | None = 10.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_TargetCrashedEvent', '10.0')) # secondsclass NavigationStartedEvent(BaseEvent):@@ -402,7 +406,7 @@ class NavigationStartedEvent(BaseEvent):target_id: TargetIDurl: str- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_NavigationStartedEvent', '30.0')) # secondsclass NavigationCompleteEvent(BaseEvent):@@ -414,7 +418,7 @@ class NavigationCompleteEvent(BaseEvent):error_message: str | None = None # Error/timeout message if navigation had issuesloading_status: str | None = None # Detailed loading status (e.g., network timeout info)- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_NavigationCompleteEvent', '30.0')) # seconds# ============================================================================@@ -429,7 +433,7 @@ class BrowserErrorEvent(BaseEvent):message: strdetails: dict[str, Any] = Field(default_factory=dict)- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_BrowserErrorEvent', '30.0')) # seconds# ============================================================================@@ -442,7 +446,7 @@ class SaveStorageStateEvent(BaseEvent):path: str | None = None # Optional path, uses profile default if not provided- event_timeout: float | None = 45.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_SaveStorageStateEvent', '45.0')) # secondsclass StorageStateSavedEvent(BaseEvent):@@ -452,7 +456,7 @@ class StorageStateSavedEvent(BaseEvent):cookies_count: intorigins_count: int- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_StorageStateSavedEvent', '30.0')) # secondsclass LoadStorageStateEvent(BaseEvent):@@ -460,7 +464,7 @@ class LoadStorageStateEvent(BaseEvent):path: str | None = None # Optional path, uses profile default if not provided- event_timeout: float | None = 45.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_LoadStorageStateEvent', '45.0')) # seconds# TODO: refactor this to:@@ -474,7 +478,7 @@ class StorageStateLoadedEvent(BaseEvent):cookies_count: intorigins_count: int- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_StorageStateLoadedEvent', '30.0')) # seconds# ============================================================================@@ -494,7 +498,7 @@ class FileDownloadedEvent(BaseEvent):from_cache: bool = Falseauto_download: bool = False # Whether this was an automatic download (e.g., PDF auto-download)- event_timeout: float | None = 30.0 # seconds+ event_timeout: float | None = float(os.getenv('TIMEOUT_FileDownloadedEvent', '30.0')) # secondsclass AboutBlankDVDScreensaverShownEvent(BaseEvent):