Change8

Migrating to Selenium selenium-4.35.0

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

Released: 8/12/2025

3
Breaking Changes
4
Migration Steps
13
Affected Symbols

⚠️ Check Your Code

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

AppCacheStatus (Java)GetTreeResult (dotnet)NavigateBack (dotnet)NavigateForward (dotnet)Keys.OPTION (Java)free_port (Python)SeleniumManager binary path handling (Python)FirefoxDriverService (Java)GeckoDriverService (Java)SafariDriverService (Java)InternetExplorerDriverService (Java)By (Java) – JSpecify annotationsCapabilities (Java) – JSpecify annotations

Breaking Changes

Issue #1

Removal of deprecated AppCacheStatus enum from the HTML5 package (Java) may break code that references it.

Issue #2

Removal of NavigateBack and NavigateForward commands from the .NET BiDi implementation breaks existing calls to those methods.

Issue #3

Removal of old stream collectors required by Java 8 may break builds on Java 8; a newer Java version is now required.

Migration Steps

  1. 1
    Replace any usage of `AppCacheStatus` with the new appropriate cache handling API.
  2. 2
    Update .NET BiDi code to remove calls to `NavigateBack` and `NavigateForward` and use the new navigation commands.
  3. 3
    Upgrade build environment to Java 11 or newer, as Java 8 stream collectors have been removed.
  4. 4
    Adjust imports to use the new @Nullable/JSpecify annotations where applicable.

Release Summary

This Selenium release adds numerous BiDi enhancements, nullable annotation support, and dependency updates while fixing several bugs and removing deprecated APIs such as AppCacheStatus and old navigation commands.

Need More Details?

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

View Full Changelog