Skip to content

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

Restore session handlers after event bus reset

lisa0314554ce8f99e83
diff --git a/browser_use/browser/session.py b/browser_use/browser/session.py
index c22c487a3..3609c05dc 100644
--- a/browser_use/browser/session.py
+++ b/browser_use/browser/session.py
@@ -686,11 +686,15 @@ class BrowserSession(BaseModel):
self.logger.info('✅ Browser session reset complete')
def model_post_init(self, __context) -> None:
- """Register event handlers after model initialization."""
+ """Initialize runtime state and register event handlers."""
self._connection_lock = asyncio.Lock()
# Initialize reconnect event as set (no reconnection pending)
self._reconnect_event = asyncio.Event()
self._reconnect_event.set()
+ self._register_session_event_handlers()
+
+ def _register_session_event_handlers(self) -> None:
+ """Register BrowserSession handlers on the current event bus."""
# Check if handlers are already registered to prevent duplicates
from browser_use.browser.watchdog_base import BaseWatchdog
@@ -742,6 +746,7 @@ class BrowserSession(BaseModel):
await self.reset()
# Create fresh event bus
self.event_bus = ResilientEventBus()
+ self._register_session_event_handlers()
async def stop(self) -> None:
"""Stop the browser session without killing the browser process.
@@ -767,6 +772,7 @@ class BrowserSession(BaseModel):
await self.reset()
# Create fresh event bus
self.event_bus = ResilientEventBus()
+ self._register_session_event_handlers()
async def close(self) -> None:
"""Alias for stop()."""
diff --git a/tests/ci/browser/test_session_start.py b/tests/ci/browser/test_session_start.py
index 4ccce869d..058b6a4ea 100644
--- a/tests/ci/browser/test_session_start.py
+++ b/tests/ci/browser/test_session_start.py
@@ -246,6 +246,26 @@ class TestBrowserSessionEventSystem:
assert browser_session.event_bus.name.startswith('EventBus_')
# Event bus name format may vary, just check it exists
+ @pytest.mark.parametrize('reset_method', ['stop', 'kill'])
+ async def test_session_handlers_registered_after_event_bus_reset(self, browser_session: BrowserSession, reset_method: str):
+ """Session handlers must be restored when stop() or kill() replaces the event bus."""
+ initial_bus = browser_session.event_bus
+ initial_handlers = {
+ event_name: [getattr(handler, '__name__', str(handler)) for handler in handlers]
+ for event_name, handlers in initial_bus.handlers.items()
+ }
+ assert initial_handlers
+ assert 'BrowserStartEvent' in initial_handlers
+ assert 'BrowserStopEvent' in initial_handlers
+
+ await getattr(browser_session, reset_method)()
+
+ assert browser_session.event_bus is not initial_bus
+ assert {
+ event_name: [getattr(handler, '__name__', str(handler)) for handler in handlers]
+ for event_name, handlers in browser_session.event_bus.handlers.items()
+ } == initial_handlers
+
async def test_event_handlers_registration(self, browser_session: BrowserSession):
"""Test that event handlers are properly registered."""
# Attach all watchdogs to register their handlers