●Change8

Migrating to Selenium selenium-4.31.0

Version selenium-4.31.0 introduces 2 breaking changes. This guide details how to update your code.

Released: 4/5/2025

2
Breaking Changes
5
Migration Steps
23
Affected Symbols

⚠️ Check Your Code

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

ContinueWithAuthCommandremote (Bazel config)wgxpathRelativeByPopupWindowFinder.InvokeExecute (protected/internal overloads)LocalValueEvaluateResultAuthCredentialsWindowProxyPropertiesChannelPropertiesScreenshotOriginLocator nested typesService.shutdown logic (Python)getNamedCookiedeleteNamedCookieDetachedShadowRootError (ErrorCode)Firefox ServiceBuilder (websocket port option)Node status response (register status)AppCacheStatusCredential (Java)Either (Java)Interaction classes (Java)

Breaking Changes

●Issue #1

ContinueWithAuthCommand behavior changed to be closer to the spec; update code that uses this command accordingly.

●Issue #2

Bazel configuration key `remote` renamed to `rbe`; update build scripts to use the new `rbe` config.

Migration Steps

  1. 1
    Update any usage of the `ContinueWithAuthCommand` to match the new specification.
  2. 2
    Replace Bazel `remote` configuration entries with `rbe` in build scripts.
  3. 3
    If your project relied on the `wgxpath` library, replace it with an alternative XPath engine as the library has been removed.
  4. 4
    Review .NET BiDi code for the newly decoupled types (EvaluateResult, AuthCredentials, etc.) and adjust imports or type references accordingly.
  5. 5
    Check for sealed `RelativeBy` usage in .NET and update any custom subclassing.

Release Summary

Selenium 4.31.0 adds several new features, fixes numerous bugs across language bindings, and introduces breaking changes for .NET BiDi ContinueWithAuthCommand and Bazel remote configuration naming.

Need More Details?

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

View Full Changelog