Change8

Migrating to Selenium selenium-4.32.0

Version selenium-4.32.0 introduces 3 breaking changes. This guide details how to update your code.

Released: 5/2/2025

3
Breaking Changes
4
Migration Steps
16
Affected Symbols

⚠️ Check Your Code

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

Selenium.WebDriver.BiDi.NetworkInterceptorSelenium.WebDriver.BiDi.Script.CallFunctionSelenium.WebDriver.BiDi.Script.EvaluateSelenium.WebDriver.LoggingSelenium.WebDriver.PrintOptionsSelenium.WebDriver.BiDi.BrowsingContextSelenium.WebDriver.BiDi.SessionSelenium.WebDriver.BiDi.NetworkSelenium.WebDriver.BiDi.Script.GenericLogEntrySelenium.WebDriver.BiDi.LocalValueSelenium.WebDriver.BiDi.WebSocketSelenium.WebDriver.BiDi.BrowserSelenium.WebDriver.BiDi.BrowsingContext.OnNavigationCommittedSelenium.WebDriver.BiDi.Network.ChromeTestsSelenium.WebDriver.BiDi.Network.EdgeTestsSelenium.WebDriver.BiDi.ClientConfig

Breaking Changes

Issue #1

dotnet BiDi network interception combine rules changed; update code to use the new combined interception API.

Issue #2

dotnet BiDi CallFunction and Evaluate no longer throw on exceptional result; check the result status instead of catching exceptions.

Issue #3

Python removed the logging API for non‑Chromium browsers; calls to driver.get_log for Firefox/Edge must be removed or guarded.

Migration Steps

  1. 1
    Update .NET BiDi code to use the new combined network interception API.
  2. 2
    Adjust .NET BiDi script calls to handle exceptional results without relying on exceptions; inspect the result's exception flag instead.
  3. 3
    Remove or guard calls to driver.get_log for non‑Chromium browsers in Python code.
  4. 4
    Migrate any old Python configuration usage to the new client_config property as indicated by deprecation messages.

Release Summary

This Selenium release adds extensive BiDi support across languages, introduces new browser and network modules, and fixes numerous test and logging issues, while breaking .NET BiDi network interception and script error handling APIs.

Need More Details?

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

View Full Changelog