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
fix: use default_factory for event_timeout to allow runtime env var configuration
tomerwave00462f9282c8
diff --git a/browser_use/browser/events.py b/browser_use/browser/events.pyindex 21a6c0858..efbff068b 100644--- a/browser_use/browser/events.py+++ b/browser_use/browser/events.py@@ -119,7 +119,7 @@ class NavigateToUrlEvent(BaseEvent[None]):# existing_tab: PageHandle | None = None # TODO# time limits enforced by bubus, not exposed to LLM:- event_timeout: float | None = _get_timeout('TIMEOUT_NavigateToUrlEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_NavigateToUrlEvent', 15.0)) # secondsclass ClickElementEvent(ElementSelectedEvent[dict[str, Any] | None]):@@ -130,7 +130,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 = _get_timeout('TIMEOUT_ClickElementEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_ClickElementEvent', 15.0)) # secondsclass ClickCoordinateEvent(BaseEvent[dict]):@@ -141,7 +141,7 @@ class ClickCoordinateEvent(BaseEvent[dict]):button: Literal['left', 'right', 'middle'] = 'left'force: bool = False # If True, skip safety checks (file input, print, select)- event_timeout: float | None = _get_timeout('TIMEOUT_ClickCoordinateEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_ClickCoordinateEvent', 15.0)) # secondsclass TypeTextEvent(ElementSelectedEvent[dict | None]):@@ -153,7 +153,7 @@ class TypeTextEvent(ElementSelectedEvent[dict | None]):is_sensitive: bool = False # Flag to indicate if text contains sensitive datasensitive_key_name: str | None = None # Name of the sensitive key being typed (e.g., 'username', 'password')- event_timeout: float | None = _get_timeout('TIMEOUT_TypeTextEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_TypeTextEvent', 15.0)) # secondsclass ScrollEvent(ElementSelectedEvent[None]):@@ -163,7 +163,7 @@ class ScrollEvent(ElementSelectedEvent[None]):amount: int # pixelsnode: 'EnhancedDOMTreeNode | None' = None # None means scroll page- event_timeout: float | None = _get_timeout('TIMEOUT_ScrollEvent', 8.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_ScrollEvent', 8.0)) # secondsclass SwitchTabEvent(BaseEvent[TargetID]):@@ -171,7 +171,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 = _get_timeout('TIMEOUT_SwitchTabEvent', 10.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_SwitchTabEvent', 10.0)) # secondsclass CloseTabEvent(BaseEvent[None]):@@ -179,7 +179,7 @@ class CloseTabEvent(BaseEvent[None]):target_id: TargetID- event_timeout: float | None = _get_timeout('TIMEOUT_CloseTabEvent', 10.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_CloseTabEvent', 10.0)) # secondsclass ScreenshotEvent(BaseEvent[str]):@@ -188,7 +188,7 @@ class ScreenshotEvent(BaseEvent[str]):full_page: bool = Falseclip: dict[str, float] | None = None # {x, y, width, height}- event_timeout: float | None = _get_timeout('TIMEOUT_ScreenshotEvent', 8.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_ScreenshotEvent', 8.0)) # secondsclass BrowserStateRequestEvent(BaseEvent[BrowserStateSummary]):@@ -198,7 +198,7 @@ class BrowserStateRequestEvent(BaseEvent[BrowserStateSummary]):include_screenshot: bool = Trueinclude_recent_events: bool = False- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserStateRequestEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserStateRequestEvent', 30.0)) # seconds# class WaitForConditionEvent(BaseEvent):@@ -213,19 +213,19 @@ class BrowserStateRequestEvent(BaseEvent[BrowserStateSummary]):class GoBackEvent(BaseEvent[None]):"""Navigate back in browser history."""- event_timeout: float | None = _get_timeout('TIMEOUT_GoBackEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_GoBackEvent', 15.0)) # secondsclass GoForwardEvent(BaseEvent[None]):"""Navigate forward in browser history."""- event_timeout: float | None = _get_timeout('TIMEOUT_GoForwardEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_GoForwardEvent', 15.0)) # secondsclass RefreshEvent(BaseEvent[None]):"""Refresh/reload the current page."""- event_timeout: float | None = _get_timeout('TIMEOUT_RefreshEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_RefreshEvent', 15.0)) # secondsclass WaitEvent(BaseEvent[None]):@@ -234,7 +234,7 @@ class WaitEvent(BaseEvent[None]):seconds: float = 3.0max_seconds: float = 10.0 # Safety cap- event_timeout: float | None = _get_timeout('TIMEOUT_WaitEvent', 60.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_WaitEvent', 60.0)) # secondsclass SendKeysEvent(BaseEvent[None]):@@ -242,7 +242,7 @@ class SendKeysEvent(BaseEvent[None]):keys: str # e.g., "ctrl+a", "cmd+c", "Enter"- event_timeout: float | None = _get_timeout('TIMEOUT_SendKeysEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_SendKeysEvent', 15.0)) # secondsclass UploadFileEvent(ElementSelectedEvent[None]):@@ -251,7 +251,7 @@ class UploadFileEvent(ElementSelectedEvent[None]):node: 'EnhancedDOMTreeNode'file_path: str- event_timeout: float | None = _get_timeout('TIMEOUT_UploadFileEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_UploadFileEvent', 30.0)) # secondsclass GetDropdownOptionsEvent(ElementSelectedEvent[dict[str, str]]):@@ -261,9 +261,8 @@ class GetDropdownOptionsEvent(ElementSelectedEvent[dict[str, str]]):node: 'EnhancedDOMTreeNode'- event_timeout: float | None = _get_timeout(- 'TIMEOUT_GetDropdownOptionsEvent',- 15.0,+ event_timeout: float | None = Field(+ default_factory=lambda: _get_timeout('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)@@ -275,7 +274,7 @@ class SelectDropdownOptionEvent(ElementSelectedEvent[dict[str, str]]):node: 'EnhancedDOMTreeNode'text: str # The option text to select- event_timeout: float | None = _get_timeout('TIMEOUT_SelectDropdownOptionEvent', 8.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_SelectDropdownOptionEvent', 8.0)) # secondsclass ScrollToTextEvent(BaseEvent[None]):@@ -284,7 +283,7 @@ class ScrollToTextEvent(BaseEvent[None]):text: strdirection: Literal['up', 'down'] = 'down'- event_timeout: float | None = _get_timeout('TIMEOUT_ScrollToTextEvent', 15.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_ScrollToTextEvent', 15.0)) # seconds# ============================================================================@@ -296,7 +295,7 @@ class BrowserStartEvent(BaseEvent):cdp_url: str | None = Nonelaunch_options: dict[str, Any] = Field(default_factory=dict)- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserStartEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserStartEvent', 30.0)) # secondsclass BrowserStopEvent(BaseEvent):@@ -304,7 +303,7 @@ class BrowserStopEvent(BaseEvent):force: bool = False- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserStopEvent', 45.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserStopEvent', 45.0)) # secondsclass BrowserLaunchResult(BaseModel):@@ -319,13 +318,13 @@ class BrowserLaunchEvent(BaseEvent[BrowserLaunchResult]):# TODO: add executable_path, proxy settings, preferences, extra launch args, etc.- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserLaunchEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserLaunchEvent', 30.0)) # secondsclass BrowserKillEvent(BaseEvent):"""Kill local browser subprocess."""- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserKillEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserKillEvent', 30.0)) # seconds# TODO: replace all Runtime.evaluate() calls with this event@@ -378,7 +377,7 @@ class BrowserConnectedEvent(BaseEvent):cdp_url: str- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserConnectedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserConnectedEvent', 30.0)) # secondsclass BrowserStoppedEvent(BaseEvent):@@ -386,7 +385,7 @@ class BrowserStoppedEvent(BaseEvent):reason: str | None = None- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserStoppedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserStoppedEvent', 30.0)) # secondsclass TabCreatedEvent(BaseEvent):@@ -395,7 +394,7 @@ class TabCreatedEvent(BaseEvent):target_id: TargetIDurl: str- event_timeout: float | None = _get_timeout('TIMEOUT_TabCreatedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_TabCreatedEvent', 30.0)) # secondsclass TabClosedEvent(BaseEvent):@@ -407,7 +406,7 @@ class TabClosedEvent(BaseEvent):# new_focus_target_id: int | None = None# new_focus_url: str | None = None- event_timeout: float | None = _get_timeout('TIMEOUT_TabClosedEvent', 10.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_TabClosedEvent', 10.0)) # seconds# TODO: emit this when DOM changes significantly, inner frame navigates, form submits, history.pushState(), etc.@@ -424,7 +423,7 @@ class AgentFocusChangedEvent(BaseEvent):target_id: TargetIDurl: str- event_timeout: float | None = _get_timeout('TIMEOUT_AgentFocusChangedEvent', 10.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_AgentFocusChangedEvent', 10.0)) # secondsclass TargetCrashedEvent(BaseEvent):@@ -433,7 +432,7 @@ class TargetCrashedEvent(BaseEvent):target_id: TargetIDerror: str- event_timeout: float | None = _get_timeout('TIMEOUT_TargetCrashedEvent', 10.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_TargetCrashedEvent', 10.0)) # secondsclass NavigationStartedEvent(BaseEvent):@@ -442,7 +441,7 @@ class NavigationStartedEvent(BaseEvent):target_id: TargetIDurl: str- event_timeout: float | None = _get_timeout('TIMEOUT_NavigationStartedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_NavigationStartedEvent', 30.0)) # secondsclass NavigationCompleteEvent(BaseEvent):@@ -454,7 +453,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 = _get_timeout('TIMEOUT_NavigationCompleteEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_NavigationCompleteEvent', 30.0)) # seconds# ============================================================================@@ -469,7 +468,7 @@ class BrowserErrorEvent(BaseEvent):message: strdetails: dict[str, Any] = Field(default_factory=dict)- event_timeout: float | None = _get_timeout('TIMEOUT_BrowserErrorEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_BrowserErrorEvent', 30.0)) # seconds# ============================================================================@@ -482,7 +481,7 @@ class SaveStorageStateEvent(BaseEvent):path: str | None = None # Optional path, uses profile default if not provided- event_timeout: float | None = _get_timeout('TIMEOUT_SaveStorageStateEvent', 45.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_SaveStorageStateEvent', 45.0)) # secondsclass StorageStateSavedEvent(BaseEvent):@@ -492,7 +491,7 @@ class StorageStateSavedEvent(BaseEvent):cookies_count: intorigins_count: int- event_timeout: float | None = _get_timeout('TIMEOUT_StorageStateSavedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_StorageStateSavedEvent', 30.0)) # secondsclass LoadStorageStateEvent(BaseEvent):@@ -500,7 +499,7 @@ class LoadStorageStateEvent(BaseEvent):path: str | None = None # Optional path, uses profile default if not provided- event_timeout: float | None = _get_timeout('TIMEOUT_LoadStorageStateEvent', 45.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_LoadStorageStateEvent', 45.0)) # seconds# TODO: refactor this to:@@ -514,7 +513,7 @@ class StorageStateLoadedEvent(BaseEvent):cookies_count: intorigins_count: int- event_timeout: float | None = _get_timeout('TIMEOUT_StorageStateLoadedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_StorageStateLoadedEvent', 30.0)) # seconds# ============================================================================@@ -534,7 +533,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 = _get_timeout('TIMEOUT_FileDownloadedEvent', 30.0) # seconds+ event_timeout: float | None = Field(default_factory=lambda: _get_timeout('TIMEOUT_FileDownloadedEvent', 30.0)) # secondsclass AboutBlankDVDScreensaverShownEvent(BaseEvent):