NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #3401 most downloaded on PyPI
SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
Latest stable
4.58.2
Last release today
19 Nov 2026
Ships on a steady schedule
a new release about every 9 days
Nearly every release is documented
notes for 60 of the last 60 stable releases
8 versions withdrawn
withdrawn after publishing
11 years old
1237 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3715 --> This resolves https://github.com/seleniumbase/SeleniumB
To avoid memory leaks in CDP Mode, upgrade to Python 3.12 (or newer).
There's an issue with asyncio in earlier versions, which makes the memory leak unavoidable.
<img width="620" alt="Screenshot 2025-04-30 at 11 47 35 AM" src="https://github.com/user-attachments/assets/2f5da52c-0237-4e21-9833-fe6940ad2637" />
Due to that, there's not much that can be done from the SeleniumBase side to avoid that specific memory leak if you're using an older version of Python. (Only CDP Mode is affected, and only for Python 3.11 and older versions.) That's because CDP Mode using asyncio in the backend, even if you don't call any async functions directly.
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.10...v4.37.11
If you're spinning up a lot of CDP Mode web browsers in a loop within a Python file, then you'll use less memory because resources will get freed up a
Your coding agent can read these notes before it upgrades. Set up the MCP server →
If you're spinning up a lot of CDP Mode web browsers in a loop within a Python file, then you'll use less memory because resources will get freed up at the end of the with SB() as sb: block, rather than after you've reached the end of the Python file (where regular garbage collection takes place).
Related discussion: https://github.com/seleniumbase/SeleniumBase/discussions/3679 - (Special thanks @felipehertzer. Joint effort with @mdmintz )
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.9...v4.37.10
Add ability to change fingerprints in realtime --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3708
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.8...v4.37.9
Update CDP Mode --> Includes various fixes and optimizations
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.7...v4.37.8
Add more CDP options --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3699
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.6...v4.37.7
Improve CDP multithreading --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3692
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.5...v4.37.6
Fix asyncio issue that appears when using multiple drivers --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3689
asyncio issueasyncio issue by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3690Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.4...v4.37.5
Fix a memory leak in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3685
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.3...v4.37.4
Mostly memory improvements by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3684
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.2...v4.37.3
Add sb.cdp.gui_click_and_hold(selector, timeframe) --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3667
sb.cdp.gui_click_and_hold(selector, timeframe)sb.cdp.gui_click_and_hold(selector, timeframe) by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3668Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.1...v4.37.2
Fix CDP Mode issues --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3654
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.37.0...v4.37.1
Selenium update by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3653
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.36.5...v4.37.0
Refresh dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3649
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.36.4...v4.36.5
CDP Mode: Patch 44 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3635
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.36.3...v4.36.4
Update geckodriver and dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3634
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.36.2...v4.36.3
Add keyword arg shortcuts for get_new_driver()
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.36.1...v4.36.2
Update CDP Mode --> Related to handling PDFs
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.36.0...v4.36.1
Mostly dependency updates by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3622
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.7...v4.36.0
CDP Mode: Patch 42 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3603
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.6...v4.35.7
Update assert_no_js_errors() --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3596
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.5...v4.35.6
CDP Mode: Patch 41 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3593
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.4...v4.35.5
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3584 (Add open_new_tab(url=None, switch_to=True) to CDP Mode) --
open_new_tab(url=None, switch_to=True) to CDP Mode)
--> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3585 (Regression with sb.cdp.clear_cookies() in 4.35.3)
--> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3586 (sb.wait_for_text_not_visible() wasn't mapping to the correct CDP Mode method)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.3...v4.35.4
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3579 --> This resolves https://github.com/seleniumbase/SeleniumB
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.2...v4.35.3
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3567 - "Simplify CDP Mode imports when using the pure CDP format
lang arg via the cdp_driver isn't taking effect"
--> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3570 - "Intermittent proxy-with-auth not being set before page load"
--> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3571 - "Simplify the pure CDP Mode API"Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.1...v4.35.2
Fix issue with post_message(message) --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3563
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.35.0...v4.35.1
Update CDP Mode --> Add sb.cdp.wait_for_element_not_visible(selector, timeout=None) --> Add sb.cdp.wait_for_element_absent(selector, timeout=None) -->
sb.cdp.wait_for_element_not_visible(selector, timeout=None)
--> Add sb.cdp.wait_for_element_absent(selector, timeout=None)
--> Always pass the timeout arg when mapping from sb to sb.cdp.selenium==4.29.0Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.17...v4.35.0
Add `element.gui_click()` to CDP Mode
element.gui_click() to CDP ModeFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.16...v4.34.17
CDP Mode - Patch 34 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3536
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.15...v4.34.16
Update proxy extension for Manifest V3 compatibility --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3517 --> This extension is
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.14...v4.34.15
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3512
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.13...v4.34.14
Fix UC Mode issue with chromedriver 133 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3501
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.12...v4.34.13
Revert the proxy scheme change from the previous release --> The previous change uncovered issues that weren't originally seen --> Going back to the w
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.11...v4.34.12
Add more proxy schemes --> This affects the Chrome extension that allows for proxy-with-auth. --> This modifies the StackOverflow solution for proxy e
scheme: ["http", "https", "socks4", "socks5"]Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.10...v4.34.11
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3489
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.9...v4.34.10
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3483 (chromedriver 133 may cause UC Mode to freeze up on reconne
uc_gui_click_captcha() method.BeautifulSoup.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.8...v4.34.9
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3479 --> This resolves https://github.com/seleniumbase/SeleniumB
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.7...v4.34.8
URL schemes and dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3476
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.6...v4.34.7
Fix issue with using multiple extension directories --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3468
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.5...v4.34.6
Fix methods for switching drivers in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3465
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.4...v4.34.5
("Chrome for Testing" and "Chrome-Headless-Shell" refactoring)
("Chrome for Testing" and "Chrome-Headless-Shell" refactoring)
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.3...v4.34.4
Add shortcuts for using "Chrome for Testing" and "Chrome-Headless-Shell" --> --cft / cft=True --chs / chs=True
--cft / cft=True ******** --chs / chs=TrueFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.2...v4.34.3
Add support for downloading browsers --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3450
Chrome for Testing and Chrome-Headless-Shell
--> See https://github.com/seleniumbase/SeleniumBase/issues/3450 for infoFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.1...v4.34.2
Update CDP Mode --> The conversion about it was on Discord: https://discord.gg/EdhQTn3EyE
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.34.0...v4.34.1
Refactor Headless Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3434
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.15...v4.34.0
Nothing published for this version
Fix missing argument bug in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3415
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.14...v4.33.15
Update the UC Mode driver patcher --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3406
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.13...v4.33.14
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3389
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.12...v4.33.13
CDP Mode - Patch 22 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3367
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.11...v4.33.12
Update Firefox options and extensions
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.10...v4.33.11
Fix a bug in CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3337
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.9...v4.33.10
Update CDP Mode --> Add sb.cdp.find_element_by_text(text, tag_name=None) --> Update sb.cdp.find_elements_by_text(text, tag_name=None)
sb.cdp.find_element_by_text(text, tag_name=None)
--> Update sb.cdp.find_elements_by_text(text, tag_name=None)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.8...v4.33.9
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3329 --> This also adds get_attribute() to CDP Mode
get_attribute() to CDP ModeFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.7...v4.33.8
CDP Mode - Patch 17 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3328
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.6...v4.33.7
Improve the multi-threading experience
pytest and multi-threading updatespytest and multi-threading updates by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3325Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.5...v4.33.6
Update pytest reports --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3318 --> A copy of completed pytest reports will get saved
pytest report updatespytest reports will get saved to last_report.htmlpytest report updates by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3319Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.4...v4.33.5
Handle edge cases regarding lock files
pytest updatespytest updates by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3317Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.3...v4.33.4
CDP Mode - Patch 16 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3312
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.2...v4.33.3
CDP Mode - Patch 15 by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/3304
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.1...v4.33.2
Update CDP Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/3297 --> (This also includes other fixes)
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.33.0...v4.33.1
One column per quarter.