Skip to content

Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.

test(browser): verify state recovery after timeout

MagMueller05b68eb5679d
diff --git a/browser_use/browser/session.py b/browser_use/browser/session.py
index 466b4a928..baef63f48 100644
--- a/browser_use/browser/session.py
+++ b/browser_use/browser/session.py
@@ -1632,9 +1632,7 @@ class BrowserSession(BaseModel):
# Clear every action lookup path before calling the model.
self.update_cached_selector_map({})
if self._dom_watchdog is not None:
- self._dom_watchdog.selector_map = {}
- self._dom_watchdog.current_dom_state = empty_dom_state
- self._dom_watchdog.enhanced_dom_tree = None
+ self._dom_watchdog.clear_cache()
cached_state = self._cached_browser_state_summary
current_target = (
diff --git a/tests/ci/browser/test_dom_listener_detection.py b/tests/ci/browser/test_dom_listener_detection.py
index 3a85977ca..017b9faba 100644
--- a/tests/ci/browser/test_dom_listener_detection.py
+++ b/tests/ci/browser/test_dom_listener_detection.py
@@ -148,6 +148,35 @@ async def test_whole_state_timeout_returns_model_visible_non_actionable_state(
assert browser_session._cached_browser_state_summary is state
+async def test_fresh_state_after_timeout_repopulates_selector_map(httpserver, browser_session: BrowserSession, monkeypatch):
+ """A timeout must not prevent the next successful state capture from rebuilding selectors."""
+ httpserver.expect_request('/recover-state').respond_with_data(
+ '<html><body><button id="continue">Continue</button></body></html>',
+ content_type='text/html',
+ )
+ await browser_session.navigate_to(httpserver.url_for('/recover-state'))
+ initial_state = await browser_session.get_browser_state_summary(include_screenshot=False)
+ assert initial_state.dom_state.selector_map
+
+ async def hang_dom_build(_watchdog: DOMWatchdog, _previous_state=None):
+ await asyncio.Future()
+
+ with monkeypatch.context() as timeout_patch:
+ timeout_patch.setenv('TIMEOUT_BrowserStateRequestEvent', '0.1')
+ timeout_patch.setattr(DOMWatchdog, '_build_dom_tree_without_highlights', hang_dom_build)
+ timed_out_state = await browser_session.get_browser_state_summary(include_screenshot=False)
+
+ assert timed_out_state.dom_state.selector_map == {}
+ assert await browser_session.get_selector_map() == {}
+
+ recovered_state = await browser_session.get_browser_state_summary(include_screenshot=False)
+ recovered_nodes = recovered_state.dom_state.selector_map
+ continue_index = next(index for index, node in recovered_nodes.items() if node.attributes.get('id') == 'continue')
+
+ assert recovered_state.state_error is None
+ assert await browser_session.get_element_by_index(continue_index) is recovered_nodes[continue_index]
+
+
async def test_initial_state_timeout_still_returns_model_visible_state(browser_session: BrowserSession, monkeypatch):
"""The first state timeout must not require an earlier cached state."""