NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #2688 most downloaded on PyPI
SeleniumBase is a framework for web crawling, scraping, and testing. Supports pytest. CDP Mode adds stealth. Includes many tools.
Last release today
25 Sep 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
1222 releases · first in 2015
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
One column per quarter.
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
Add "driver.uc_switch_to_frame(frame)" --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2282
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.1...v4.21.2
Prevent internal WebDriver issue from disrupting tests --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2259
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.21.0...v4.21.1
Fix a bug with getting the latest milestone driver version
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.20.9...v4.21.0
Fix headless UC Mode (caused by missing args) --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2230
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.20.8...v4.20.9
Add more options for capturing CDP logs --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2220
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.20.7...v4.20.8
Add way to generate multiple Presenter slides from one --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2208
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.20.6...v4.20.7
Prevent various prompts from appearing --> Prevent "Customize Chrome", "Permission", and "Translate" prompts from appearing. --> This resolves https:/
Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.20.5...v4.20.6
Prevent the "Enhanced ad privacy" pop-up --> This resolves https://github.com/seleniumbase/SeleniumBase/issues/2201 --> (This issue only appeared when
user-data-dir)Full Changelog: https://github.com/seleniumbase/SeleniumBase/compare/v4.20.4...v4.20.5
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →