Manage a browser session

​

Session termination

1. Automatic timeout Sessions have a default timeout configured at the project level, which can be customized when creating a session. For longer-running tasks, enable keep alive.
2. Manual termination You can end sessions explicitly by closing the browser programmatically (browser.close() or driver.quit()), using the Sessions API, or releasing keep-alive sessions when no longer needed.
3. Unhandled errors Unhandled errors in your automation code can cause your script to disconnect from the browser, ending the session prematurely. Common scenarios include network interruptions, uncaught exceptions, or exceeded resource limits. To prevent premature termination, make sure to implement proper error handling and cleanup in your code.

​

CDP connection idle timeout

// Send a CDP command every 5 minutes to keep the connection open
setInterval(
  async () => {
    await page.evaluate(() => undefined);
  },
  5 * 60 * 1000,
);

import asyncio


# Send a CDP command every 5 minutes to keep the connection open
async def heartbeat(page):
    while True:
        try:
            await asyncio.sleep(5 * 60)
            await page.evaluate("undefined")
        except Exception:
            break


asyncio.create_task(heartbeat(page))

​

Session timeout settings

​

Debugging completed sessions

​

Measuring usage

​

Related guides