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.3
Last release today
21 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
1238 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Refactor UC Mode and refresh dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2939
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.28.5...v4.28.6
Make UC Mode more advanced by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2919
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.28.4...v4.28.5
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add UC Mode clicking methods --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2910
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.28.3...v4.28.4
Nothing published for this version
Fix Windows bug in UC Mode for uc_gui_handle_cf() --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2889
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.28.2...v4.28.3
Improve multithreading in UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2883
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.28.1...v4.28.2
Add support for uc_gui_handle_cf() in the Driver() formats --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2879
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.28.0...v4.28.1
Make multiple improvements to UC Mode
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.27.5...v4.28.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Update default browser options by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2843
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.27.4...v4.27.5
Refactor Chromium options --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2836
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.27.3...v4.27.4
Downgrade pytest temporarily to fix an issue --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2832
pytest version to fix an issuepytest version to fix an issue by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2834Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.27.2...v4.27.3
Refresh Python dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2831
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.27.1...v4.27.2
Update sb.open_new_window() for UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2823
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.27.0...v4.27.1
Refresh Python dependencies --> This includes upgrading to selenium==4.21.0
selenium==4.21.0Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.26.4...v4.27.0
Update options --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2768 --> With --ee: End tests early with ESC ("Skipped"). End Rec
--ee: End tests early with ESC ("Skipped"). End Recorder Mode with SHIFT then ESC.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.26.3...v4.26.4
Add / improve methods that highlight elements --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2747 --> Now, self.highlight(selec
self.highlight(selector) can also accept a WebElement for the selector.
--> Adds self.highlight_elements(selector), which highlights all elements that match the selector.Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.26.2...v4.26.3
Add command-line shortcuts for SB() and Driver() --> This adds the following missing command-line shortcuts for SB() and Driver() formats:
SB() / Driver() formatsSB() and Driver() formats:
------> --gui / --headed (override the default headless mode on Linux)
------> --xvfb (for the SB() format only)
------> --pls=none (Page Load Strategy)
------> --pls=eager (Page Load Strategy)
------> --pls=normal (Page Load Strategy)SB() / Driver() formats by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2740Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.26.1...v4.26.2
Refresh Python dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2736
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.26.0...v4.26.1
Refresh Python dependencies --> This includes upgrading to selenium==4.20.0
selenium==4.20.0Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.25.4...v4.26.0
Update the Docker integration --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2692 --> This resolves https://github.com/selenium
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.25.3...v4.25.4
Add UC Mode "driver" methods directly into the "SB" API --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2684
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.25.2...v4.25.3
Fix issue with escaping characters in UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2666
driver.uc_click(selector)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.25.1...v4.25.2
Refresh optional Python dependencies
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.25.0...v4.25.1
UC Mode refinements and more by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2649
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.12...v4.25.0
Make UC Mode great again --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2626
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.11...v4.24.12
Light refactoring by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2616
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.10...v4.24.11
Fix issue with getting browser version from Chrome-for-Testing on Windows --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2613
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.9...v4.24.10
Fix the "binary_location" option on Windows --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2610
binary_location option on Windowsbinary_location option on Windows by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2611Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.8...v4.24.9
Refactoring and IE compatibility by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2607
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.7...v4.24.8
Fix browser-version-detection on Windows --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2603
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.6...v4.24.7
Add way to hide file-save output for Presenter / ChartMaker --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2600
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.5...v4.24.6
Add methods and update UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2581 --> This resolves https://github.com/seleniu
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.4...v4.24.5
Improve non-pytest script processing during pytest collection --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2575
pytest collection and moreFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.3...v4.24.4
Update Recorder Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2553
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.2...v4.24.3
Allow truncated URLs in UC Mode
reconnect_time for uc_click()sbase mkdir DIRFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.1...v4.24.2
Refresh dependencies and examples by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2538
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.24.0...v4.24.1
Improve error-handling around browser launches --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2532
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.7...v4.24.0
Fix user-agent string in headless UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2523
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.6...v4.23.7
Update chromedriver download origin --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2519
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.5...v4.23.6
Refresh Python dependencies --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2507
After upgrading to pytest 8.0.1, all tests that ran on Python 3.13.0a4 passed.
Might as well say that Python 3.13 is now officially supported in seleniumbase! ⭐
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.4...v4.23.5
Add support for the newer chromedriver download origin --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2497
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.3...v4.23.4
Refresh JS and Python dependencies by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2484
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.2...v4.23.3
Update the default UC Mode reconnect_time
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.1...v4.23.2
Fix option for enabling 3D APIs --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2449 --> (Use --enable-3d-apis or enable_3d_apis
--enable-3d-apis or enable_3d_apis=True to activate.)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.23.0...v4.23.1
Refresh dependencies --> Includes upgrading selenium to 4.17.2
selenium and other dependenciesselenium to 4.17.2Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.6...v4.23.0
Add options for disabling Chromium features --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2440 --> This resolves https://githu
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.5...v4.22.6
Upgrade the default geckodriver version to v0.34.0 --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2411
browserstack" or "bstack" in your YAML file to set "bstack:options".)
----> (See SeleniumBase/examples/capabilities to learn how to set capabilities in remote tests.)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.4...v4.22.5
Add YAML option for parsing capabilities --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2401 --> This resolves https://github.c
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.3...v4.22.4
Expand firefox_pref="KEY:VALUE" to allow URLs as VALUEs --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2386 --> This resolves h
firefox_pref to allow URLs as VALUEs in KEY:VALUE pairsFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.2...v4.22.3
Add "breakpoint" option for reconnecting in UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2384
"breakpoint" option for reconnecting in UC ModeOther unrelated changes:
Currently, some UC Mode methods let you set a custom reconnect_time / timeout (in seconds) to specify how long the driver should be disconnected from Chrome to prevent detection before reconnecting again. The new plan here is to add an option of "breakpoint" for that arg's value. Doing this should drop in a Python breakpoint() while the driver is disconnected from the browser. This will allow the user to perform manual actions (until typing c and pressing ENTER to continue from the breakpoint).
Here are those existing methods: (Use self.driver for BaseCase formats. Use sb.driver for SB() formats):
driver.uc_open_with_reconnect(url, reconnect_time)
# Examples:
driver.uc_open_with_reconnect("https://nowsecure.nl/#relax", reconnect_time=5)
driver.uc_open_with_reconnect("https://nowsecure.nl/#relax", 5)
driver.reconnect(timeout)
# Examples:
driver.reconnect(5)
driver.reconnect(timeout=5)
With this change, you'll now be able to set the reconnect_time / timeout to "breakpoint" as a valid option.
Instead of waiting for a set time, the program will run a Python breakpoint() so that the user will be able to continue when ready (using c + ENTER):
Examples that should work once this ticket is completed:
driver.uc_open_with_reconnect("https://nowsecure.nl/#relax", reconnect_time="breakpoint")
driver.uc_open_with_reconnect("https://nowsecure.nl/#relax", "breakpoint")
driver.reconnect(timeout="breakpoint")
driver.reconnect("breakpoint")
"breakpoint" option for reconnecting in UC Mode by @mdmintz in https://github.com/seleniumbase/SeleniumBase/pull/2385Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.1...v4.22.2
Fix UC Mode headless issue on macOS for Chrome 120+ --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2375
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.22.0...v4.22.1
[Fix bugs related to driver.capabilities["browserName"]](https://github.com/seleniumbase/SeleniumBase/commit/fc684c3698193e8bc048d5197f712cb0136fcb55)
seleniumselenium==4.16.0Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.7...v4.22.0
Update the UC Mode chromedriver patcher --> This resolves #2332: (UC Mode): Traces of chromedriver found in Chrome Devtools Console
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.6...v4.21.7
Add Chromium browsers for use via "binary_location" --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2324
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.5...v4.21.6
Fix a Recorder bug caused by Python PATH whitespace --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2320
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.4...v4.21.5
Hide the "Find your downloads here" bubble on Chrome
Find your downloads here" bubble on ChromeFull Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.3...v4.21.4
Fix a Windows issue with UC Mode --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2289
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.2...v4.21.3
One column per quarter.