●Change8

Migrating to Selenium selenium-4.37.0

Version selenium-4.37.0 introduces 6 breaking changes. This guide details how to update your code.

Released: 10/18/2025

6
Breaking Changes
6
Migration Steps
19
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

ChromeOptionsEdgeOptionsClientConfigHasBiDiHasDevToolsBiDiNetworkFtpProxyIEnumerable<CommandResult>HttpClientWebSocketVirtualAuthenticatorSeleniumManagerGrid.EventBusJava HttpClient interfaceJava invisibilityOf methodJava os.arch handlingPython driver subclass delete downloadsPython WebServer mimetype guessing

Breaking Changes

●Issue #1

Python 3.9 support removed; upgrade to Python >=3.10 (or 3.14) to use this release.

●Issue #2

IEnumerable of command results removed from the .NET BiDi API; update code to use the new specific result types.

●Issue #3

Obsolete FtpProxy class removed from the .NET library; replace usage with alternative proxy configuration.

●Issue #4

JSON converter attributes moved from centralized options to their respective types in .NET; adjust serialization attribute usage.

●Issue #5

Browser protocol file fetching adapted to a new file structure; update any custom fetching logic accordingly.

●Issue #6

Removal of the Firefox guard for canListenToDownloadWillBeginEvent may affect listeners; adjust event handling.

Migration Steps

  1. 1
    Upgrade your Python runtime to >=3.10 (or 3.14) and adjust any code that relied on Python 3.9 behavior.
  2. 2
    Replace usage of IEnumerable<CommandResult> with the new specific result types in .NET BiDi code.
  3. 3
    Remove references to the obsolete FtpProxy class and configure proxies using the new mechanisms provided.
  4. 4
    Update .NET BiDi serialization attributes to the new per‑type locations instead of the centralized options.
  5. 5
    If you have custom logic that fetches browser protocol files, modify the paths to match the new file structure.
  6. 6
    Review event listeners for download events and remove reliance on the removed Firefox guard.

Release Summary

Selenium 4.x release adds extensive BiDi enhancements, native Java 11 HTTP client methods, drops Python 3.9 support, and includes numerous bug fixes and new features across all language bindings.

Need More Details?

View the full release notes and all changes for Selenium selenium-4.37.0.

View Full Changelog