●Change8

Migrating to Selenium selenium-4.46.0

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

Released: 7/11/2026

3
Breaking Changes
2
Migration Steps
6
Affected Symbols

⚠️ Check Your Code

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

UrlTemplate.matchEither.streamEither.iteratorRemoteWebDriverSafariOptionsWebDriverWait

Breaking Changes

●Issue #1

Java: Methods to avoid internal BiDi connection surfacing on driver have been deprecated. This might break code that directly interacts with internal BiDi connections.

●Issue #2

Java: JSON number lexer has been tightened to match RFC 8259. This may break parsing of numbers that were previously accepted but are now considered invalid.

●Issue #3

Java: Commas between JSON elements are now enforced, and trailing commas are accepted. This might break parsing of JSON strings that relied on non-standard comma usage.

Migration Steps

  1. 1
    Java: Migrate code that relies on internal BiDi connections to use the new APIs that abstract BiDi connections.
  2. 2
    Java: Review and update JSON parsing logic if it relies on non-standard number formats or comma usage that is now rejected.

Release Summary

This release introduces several improvements across multiple language bindings, including enhanced BiDi support, better JSON parsing, and fixes for driver routing and build processes. Key updates include Java's BiDi integration and stricter JSON handling, alongside Ruby's HTTP client customization.

Need More Details?

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

View Full Changelog