●Change8

Migrating to Selenium selenium-4.33.0

Version selenium-4.33.0 introduces 4 breaking changes. This guide details how to update your code.

Released: 5/23/2025

4
Breaking Changes
5
Migration Steps
14
Affected Symbols

⚠️ Check Your Code

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

RemoteStatussetScriptTimeoutpageLoadTimeoutRequireexecuteNetwork._on_requestLogLevelShadowRoot.idselenium.webdriver.bidi.storageselenium.webdriver.bidi.web_extensionGrid.UI.sessionsGrid.UI.overviewclean_optionsrust.WMIC

Breaking Changes

●Issue #1

Removed RemoteStatus class from the Java API; code referencing it must be updated to use alternative status handling.

●Issue #2

Removed deprecated setScriptTimeout and pageLoadTimeout methods from the Java WebDriver; replace with appropriate timeout configuration.

●Issue #3

Removed deprecated items in Require.java; update imports and usage accordingly.

●Issue #4

Python execute method now includes a `message` attribute in its exception; catch and handle the new attribute.

Migration Steps

  1. 1
    Update Java code to remove references to RemoteStatus, setScriptTimeout, pageLoadTimeout, and any removed Require.java items.
  2. 2
    In Python, adjust exception handling for the execute method to use the new `message` attribute.
  3. 3
    Review and update any code that relied on the previously missing `id` property now present in ShadowRoot.
  4. 4
    Refresh Python dependencies to the latest versions as specified in the updated requirements.
  5. 5
    Run tests with the new clean_options fixture if custom fixtures are used.

Release Summary

Selenium 4.33.0 introduces new BiDi modules, UI enhancements, and several deprecations removals while fixing type‑checking and download errors. Users need to adjust Java code for removed APIs and handle the new `message` field in Python execute exceptions.

Need More Details?

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

View Full Changelog