Selenium 4.27 Released!

Today we’re happy to announce that Selenium 4.27 has been released!

We’re very happy to announce the release of Selenium 4.27 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Here is the latest iteration of the world’s most popular browser automation tool! This release brings significant updates across all supported languages, enhancing functionality, performance, and compatibility. From new features like FedCM command support in Python and improved BiDi handling in .NET to critical deprecations like CDP methods for Firefox.

General Highlights

  • Chrome DevTools support is now: v131, v128, and v127 (Firefox still uses v85 for all versions)
  • Selenium has over 5.1M active users in the last 30 days. 300K more than 1 month ago!
  • Deprecation of CDP methods for Firefox across several bindings to align with evolving automation standards.
  • Enhanced Selenium Grid with improved session handling, distributed retry logic, and faster server shutdown processes.
  • Updates for .NET and Java to modernize exception handling, improve BiDi support, and address compatibility warnings.
  • Deprecation of getAttribute in multiple languages as part of Selenium’s evolution.

Python

  • Deprecated CDP methods for Firefox. (e2e9ac5f7e)
  • Replaced imghdr with filetype for better compatibility. (b1828bf108)
  • Moved project metadata from setup.py to pyproject.toml. (673d2c78be)
  • Added FedCM command support. (d3d8070d50)
  • Introduced backward compatibility for AppiumConnection. (3a3c46b3c1)
  • Added user agent and extra headers via ClientConfig. (e2023893c7)
  • Addressed DetachedShadowRoot exception handling. (7aabb8d1b4)

Ruby

  • Deprecated CDP methods for Firefox. (e9c09a200e)
  • Resolved deprecation warnings for the uri gem. (751bacb6bc)
  • Added BiDi navigation commands and support for network interception. (573c8fe961)

Java

  • Enhanced error messages for NoSuchElementException. (4a0d05e50e)
  • Deprecated WebElement.getAttribute(). (cd7303c437)
  • Introduced methods for selecting options containing specific text. (b4b8aaba2b)
  • Added Firefox CDP deprecation warnings. (19fc217985)

.NET

  • Added CDP deprecation warnings for Firefox. (8f725b3a80)
  • Improved BiDi and async support across modules. (9054e892cc)
  • Enabled nullability annotations for better type safety. (d9149acc09)
  • Introduced compatibility improvements for actions with clashing device names. (a9ec9ca682)
  • Deprecated GetAttribute method for WebElements. (ac523a5d0a)

JavaScript

  • Enabled BiDi tests for locating nodes with Chrome and Edge. (339421538b)
  • Enhanced support for authentication handlers in BiDi commands. (25551adfe8)
  • Updated dependencies to resolve security alerts. (3906742748)

Rust

  • Selenium Manager now honors full browser versions. (fe5b1985e5)
  • Updated logic to prioritize stable versions for Firefox management. (0d2dda17b4)

Selenium Grid

  • Improved retry logic for session creation in distributed grids. (e4ab299ea4)

  • Improved session handling in Selenium Grid and reduced test flakiness. (b0464e1adf)

  • Enhanced server shutdown for faster termination. (62aa0e551e)

  • Implemented graceful handling of stale sessions and client timeouts. (b0464e1adf)

  • Improved detection of unsupported HTTP methods during request handling. (f56b3d07d9)


Docker Selenium

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Swastik Baranwal

Swastik Baranwal

Michael Render

Michael Render

Andrew Nesbitt

Andrew Nesbitt

Ed Manlove

Ed Manlove

Jose D. Gomez R.

Jose D. Gomez R.

Navin Chandra

Navin Chandra

Natalia Pozhidaeva

Natalia Pozhidaeva

Sandeep Suryaprasad

Sandeep Suryaprasad

Simon Benzer

Simon Benzer

Selenium Docs & Website

Michael Render

Michael Render

Yevgeniy Shunevych

Yevgeniy Shunevych

ian zhang

ian zhang

Jason Ren

Jason Ren

Navin Chandra

Navin Chandra

Simon Benzer

Simon Benzer

Andrew Zipperer

Andrew Zipperer

Docker Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

Agustin Pequeno

Agustin Pequeno

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Viet Nguyen Duc

Viet Nguyen Duc

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy automating!

Selenium 4.26 Released!

Today we’re happy to announce that Selenium 4.26 has been released!

We’re very happy to announce the release of Selenium 4.26 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Selenium 4.26.0 release introduces new features, key enhancements, and numerous bug fixes across different languages and components. This version focuses on improving compatibility, updating dependencies, enhancing internal logging, and providing broader WebDriver capabilities. Here are the most important updates:

General Highlights

  • Chrome DevTools support is now: v130, v129, and v128 (Firefox still uses v85 for all versions)

  • Selenium has at least 4.8M active users in the last 30 days. 800K more than 1 month ago!

  • Selenium Manager Enhancements: Added better handling for invalid browser versions and improved logging, helping to streamline browser management.

  • Expanded BiDi (Bidirectional WebDriver Protocol) Support for .NET: Continuing the work on BiDi for .NET, this release includes improved WebSocket communication, CDP DevTools integration, and expanded logging, advancing real-time and bidirectional interactions.

  • Grid UI Enhancements: New sorting options by Platform, Status, and ID, session timeout display, and WebSocket connection management for better performance and user experience.

  • CI/CD Pipeline Improvements: Numerous updates for CI workflows, such as artifact handling and new testing configurations, to boost stability and developer productivity.


.NET

  • Updated WebSocket communication and DevTools integration in the BiDi implementation, adding extensive internal logs to improve diagnostics (#14566, #14558).

  • Added support for the GetLog command in the Remote WebDriver (#14549).

  • Enhanced configuration for PrintOptions, allowing direct control over PageDimensions and PageMargins (#14593).

  • Deprecated several old constructors for cleaner exception handling and improved compatibility with Ahead-of-Time (AOT) compilation (#14574).


Java

  • Increased property scope for improved compatibility with Appium (#14183).

  • Updated SpotBugs settings and fixed issues in ChromiumDriver and PortProber for cleaner code (#14589).

  • Added PAC proxy URL support for Selenium Manager to expand proxy configuration capabilities (#14506).


Python

  • Added more internal logging for CDP, and configured WebDriver HTTP client settings for enhanced performance (#14668, #13286).

    Explore the various configuration parameters for the WebDriver HTTP client.

  • Removed deprecated EdgeService parameters and eliminated Python 2.x code from various test files (#14563, #14502).

  • Set consistent polling for WebDriverWait methods to align behavior between Java and Python implementations (#14626).

  • Improves binding extensibility for seamless integration of Selenium into Appium’s Python client. (#14587).


JavaScript

  • Closed BiDi WebSocket connection on session end, improving session management in BiDi (#14507).

  • Fixed issues with sendKeys command, addressing errors in FileDetector handling (#14663).


Ruby

  • Added RBS type support for BiDi-related classes, aligning with updates for Ruby BiDi compatibility (#14611).

  • Updated BiDi script structures to match recent specifications for consistent implementation (#14236).


Selenium Grid

  • New Grid UI features for sorting and WebSocket management, adding clarity and control to session management (#14571, #14598, #14599).

  • Enabled async requests in httpclient to enhance request handling performance (#14409).

  • Improved node handling for better scalability and stability (#14628).


Docker Selenium

  • Updated FFmpeg v7.1 in video recorder (#2439).

  • Updated in Helm chart for Selenium Grid deployment to Kubernetes

    • Add GraphQL metrics exporter for monitoring (#2425).
    • Add templates for Relay node (#2453).
    • Allow to overwrite config videoRecorder in each node (#2445).

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Swastik Baranwal

Swastik Baranwal

Rob Brackett

Rob Brackett

Michael Render

Michael Render

Agustin Pequeno

Agustin Pequeno

David Bernhard

David Bernhard

Priyansh Garg

Priyansh Garg

Navin Chandra

Navin Chandra

Simon Benzer

Simon Benzer

Selenium Docs & Website

Abdelrahman Magdy Ellithy

Abdelrahman Magdy Ellithy

Swastik Baranwal

Swastik Baranwal

ian zhang

ian zhang

Harshit Bhardwaj

Harshit Bhardwaj

Simon Benzer

Simon Benzer

Andrew Zipperer

Andrew Zipperer

Docker Selenium

Bruno Brito

Bruno Brito

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Viet Nguyen Duc

Viet Nguyen Duc

Project Highlights

This year marks a monumental milestone—20 years of Selenium transforming browser automation! Since its inception as a modest open-source project, Selenium has grown into the world’s most trusted tool for web automation, powering testing and development for countless users globally. From revolutionizing open-source collaboration to shaping automation practices, Selenium has impacted developers, testers, and organizations worldwide.

To honor this journey, the Selenium team hosted a special webinar on October 28th, 2024, where the leadership team shared insights on Selenium’s evolution, the latest advancements in WebDriver BiDi, and exciting prospects for the future. If you’d like to learn more about Selenium’s incredible journey and future plans, head to the official blog post here.

Special thanks to the Selenium community for your continued support and contributions, to the entire Selenium team for their dedication and hard work, and to Pallavi Sharma and Maaret Pyhäjärvi for organizing and leading this event.

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy automating!

Celebrating 20 Years of Selenium: A Journey of Innovation in Browser Automation

Celebrating 20 Years of Selenium!

This year marks a monumental milestone—20 remarkable years of Selenium, the tool that revolutionized browser automation! We’re thrilled to invite you to a special event to commemorate this incredible journey: Celebrating 20 Years of Selenium

Two Decades of Selenium: Revolutionizing Open Source Browser Automation and Testing Over the past two decades, Selenium has reshaped the automation landscape, evolving from a simple tool into the backbone of browser automation across the globe. What began as a modest open-source project has grown into the most trusted tool for web automation, embraced by developers, testers, and businesses alike. As we celebrate Selenium’s 20th birthday on October 28th, we invite you to join a special webinar that honors the tool itself and the incredible community that has powered its success. Governed by the Software Freedom Conservancy, Selenium’s legacy is built on open-source collaboration and the passion of its contributors. The webinar begins at 11:30 AM GMT on October 28th, 2024, and will be packed with two hours of insightful talks from the Selenium Leadership Team. We’ll explore the project’s current advancements, the cutting-edge work in the WebDriver BiDi space, and what lies ahead for the next decade of Selenium. Here’s what you can expect:

Meet the Speakers:

  1. Diego Molina – Selenium Project Leadership & Technical Leadership Topic: “Choosing the Right Framework: Exploring the Selenium Ecosystem for Testing” Diego will dive into a critical discussion on Selenium’s role in the broader testing ecosystem. He’ll explore whether Selenium remains the best option for web testing, considering the wide array of available frameworks. Expect valuable insights into Selenium’s advantages, limitations, and how to choose the right tool for your needs.

  2. Puja Jagani – Selenium Technical Leadership Topic: “BiDi-powered Selenium: Shaping Tomorrow’s Automation” Puja, a leading contributor to the WebDriver BiDi initiative, will give us a glimpse into the future of automation. Her talk will explore how the W3C BiDi protocol transforms browser automation with event-driven testing capabilities, offering improved performance and cutting-edge features that will redefine the automation landscape.

  3. Q and A - With Folks From Selenium Project

Why You Should Attend This webinar is more than just a celebration—it’s a chance to learn from the visionaries driving Selenium’s evolution. Whether you’re a seasoned professional or new to browser automation, this event offers invaluable insights into Selenium’s past, present, and future. 💻 Event Registration: Celebrating 20 Years of Selenium 📅 Date & Time: October 28th, 2024, at 11:30 AM GMT

Join Us in Celebrating Selenium’s Incredible Journey! For 20 years, Selenium has helped shape how we test, automate, and innovate on the web. This is your opportunity to celebrate that legacy and learn what the future holds for browser automation. We can’t wait to see you there! Event Organizers - Maaret, Diego, and Pallavi.

Watch the Recording of Our 20th Anniversary Event

Couldn’t join us live? Watch the entire “Celebrating 20 Years of Selenium” event on YouTube. Relive the milestone moments, hear directly from the Selenium leadership team, and get insights into the future of browser automation.

📹 Recording Link: Watch the Event Recording on YouTube

This recording covers the highlights, including discussions on Selenium’s evolution, its role in the testing ecosystem, and the exciting advancements in WebDriver BiDi.

Announcing SeleniumConf & AppiumConf 2025

SeleniumConf and AppiumConf are back in person!

We’re thrilled to announce that SeleniumConf & AppiumConf is returning for 2025, bringing together browser and mobile automation enthusiasts from around the world. This must-attend event will take place from March 26-28, 2025, in the vibrant city of Valencia, Spain!

This year, the conference will gather over 400 browser and mobile automation professionals, including developers, testers, quality managers, test architects, and others, to explore the latest trends in browser and mobile automation, including cutting-edge topics like AI in automation, game testing, accessibility automation, and much more. Whether you’re new to automation or an experienced professional, this conference is designed to offer actionable insights and practical knowledge that you can take back to your team.

Why Attend?

  • Unparalleled Learning: Get hands-on training and real-world insights from world-class experts in Selenium, Appium, and the broader WebDriver ecosystem. Learn how automation tools like WebdriverIO, Puppeteer, Nightwatch, and more are pushing the boundaries of testing.
  • AI & Automation: Discover how AI is reshaping browser and mobile automation and learn practical techniques integrating AI into your testing workflows.
  • Workshops & Networking: Full-day workshops on March 26 offer deep dives into advanced topics like Selenium Grid with Kubernetes, Advance Appium or Selenium Deep Dive. Plus, with so many professionals on-site, it’s the perfect opportunity to grow your network and meet project leads, committers, and fellow testers.
  • Scenic Valencia: All of this will take place at the stunning Veles e Vents event building, located right by the Mediterranean Sea. And don’t worry, we’ve got special hotel rates just for you!

Mark Your Calendar 🗓️

  • Call for Proposals and ticket sales open on October 15, 2024. Take your chance to submit a talk or secure your spot at this exciting event!
  • The conference workshops will be posted on October 15, 2024, so stay tuned! In the meantime, visit www.seleniumconf.com for more details and to plan your trip.

Help Spread the Word!

Excited about SeleniumConf & AppiumConf 2025? Share this event with your colleagues, friends, and fellow automation enthusiasts. Remember to follow us for updates and visit www.seleniumconf.com to learn more.

Happy testing!

Selenium 4.25 Released!

Today we’re happy to announce that Selenium 4.25 has been released!

We’re very happy to announce the release of Selenium 4.25 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Selenium 4.25.0 introduces several important changes and improvements across multiple programming languages and build systems. Below are the key highlights from this release.

General Updates

  • Chrome DevTools support is now: v129, v128, and v127 (Firefox still uses v85 for all versions)

  • Selenium has at least 4M active users in the last 30 days. 1.5M more than 4 months ago!

  • First implementation of BiDi (Bidirectional WebDriver Protocol) for .NET, providing advanced capabilities like inspecting browser contexts and receiving real-time events.

    • We are looking for feedback on this feature, so please try it out and let us know what you think! Try var bidi = await driver.AsBiDiAsync(); to get started.

Java

  • Escape cookie values when required for tests (#14486)

  • Warn about an upcoming change enforcing string quotes in TOML (#14491)

  • See all changes


Python

  • Fixed type errors for pointer_input.py, wheel_input.py, and firefox/options.py (#14476)

  • Fixed failing BiDi tests (#14448)

  • Dropped support for Python 2.x in firefox_profile.py (#14489)

  • See all changes


JavaScript

.NET

  • BiDi API updates, including renaming methods and simplifying context handling (#14318)

  • Exposed BiDi associated references in browsing context (#14495)

  • See all changes


Ruby

  • Allowed driver path to be set using environment variables (#14287)

  • Fixed the add_cause method not being able to process an array of hashes (#14433)

  • See all changes


Rust

  • Fixed errors in Selenium Manager when the browser path is incorrect (#14381)
  • Reused driver mirror URLs to discover Firefox versions (#14493)
  • See all changes

Docker Selenium

  • KEDA Scaler in Kubernetes:

    • Enhanced KEDA scaler behavior, addressing:
      • Node with different platformName scaling: Fixed incorrect scaling behavior when both Linux and Windows node stereotypes are present (#1925).
      • Excessive autoscaling: Resolved over-scaling of browser nodes (#2160).
    • Added separate parameters for basic authentication (username, password) for the Grid GraphQL endpoint (#2401).
    • Added support for nodeMaxSessions parameter to control maximum concurrent sessions per node, aligning with the node config --max-sessions (#2402).

    Note: The above KEDA scaler updates are available experimentally via our built images approach. Check out this for more details.

  • Selenium Grid Helm Chart: Updated to support the new KEDA scaler enhancements.

  • See all changes

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Swastik Baranwal

Swastik Baranwal

Agustin Pequeno

Agustin Pequeno

Angie Jones

Angie Jones

Chris Gossett

Chris Gossett

Dominic Evans

Dominic Evans

Manuel Blanco

Manuel Blanco

Navin Chandra

Navin Chandra

Sandeep Suryaprasad

Sandeep Suryaprasad

Simon Benzer

Simon Benzer

Selenium Docs & Website

Agustin Pequeno

Agustin Pequeno

Simon Benzer

Simon Benzer

Docker Selenium

Markus Kopp

Markus Kopp

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Viet Nguyen Duc

Viet Nguyen Duc

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy automating!

Selenium 4.24 Released!

Today we’re happy to announce that Selenium 4.24 has been released!

We’re very happy to announce the release of Selenium 4.24.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Noteworthy changes per language

  • Java
    • BiDi Prompt/Alert Test Fix: Fixed prompt/alert related tests if BiDi is enabled.
    • Execute Script API: Added execute script high-level API for BiDi.
    • JSpecify Annotations: Added JSpecify annotations for WebDriver, WebElement, SearchContext, and other interfaces.
    • Dom Mutation Handler Support: Added DOM mutation handler support for BiDi.
    • Close HttClient on Session Failure: Ensured HttClient is closed if starting the session fails.
    • System Property to Disable Tracing: Added a system property to disable tracing. (c8676eff10)
    • See all changes

  • JavaScript
    • High-Level Script Command for BiDi: Added a high-level script command for BiDi.
    • Authentication Handlers for BiDi: Added authentication handlers for BiDi.
    • Expose Selenium Version for Node.js: Exposed the Selenium version for Node.js.
    • See all changes

  • .NET
    • Migration to System.Text.Json: Migrated from Newtonsoft.Json to System.Text.Json package.
    • See all changes

  • Python
    • Unhandled Prompt Behavior: Added unhandled prompt behavior to ‘ignore’ option if BiDi is enabled.
    • Mypy Error Fixes: Fixed mypy errors for various modules.
    • Pytest Configuration Update: Moved pytest configuration settings to pyproject.toml.
    • Global Default Timeout Override: Allowed overriding GLOBAL_DEFAULT_TIMEOUT.
    • See all changes

  • Ruby
    • Deprecate WebStorage JS Methods: Deprecated WebStorage JavaScript methods.
    • See all changes

  • Rust
    • Skipping Drivers and Browsers in Path: Included arguments for skipping drivers and browsers in the path. (a056044d9c)
    • Use Debug Format Specifier: Used the Debug format specifier to display error messages. (d8a7172a2a)
    • Firefox Version Discovery: Used Firefox history major releases endpoint for version discovery. (02d6903006)
    • See all changes

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

MustafaAgamy

MustafaAgamy

Agustin Pequeno

Agustin Pequeno

Angie Jones

Angie Jones

Chris Gossett

Chris Gossett

Diogo Teles Sant'Anna

Diogo Teles Sant'Anna

Dominic Evans

Dominic Evans

Lauro Moura

Lauro Moura

Manuel Blanco

Manuel Blanco

Michael Mintz

Michael Mintz

Navin Chandra

Navin Chandra

Pavel Sobolev

Pavel Sobolev

Sandeep Suryaprasad

Sandeep Suryaprasad

Simon Benzer

Simon Benzer

Selenium Docs & Website

MustafaAgamy

MustafaAgamy

Agustin Pequeno

Agustin Pequeno

ian zhang

ian zhang

Pedro Aguiar

Pedro Aguiar

Pablo Martinez

Pablo Martinez

Scott Babcock

Scott Babcock

Simon Benzer

Simon Benzer

Marek Andreansky

Marek Andreansky

Docker Selenium

Ilia Lazebnik

Ilia Lazebnik

Nandor Pal

Nandor Pal

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Viet Nguyen Duc

Viet Nguyen Duc

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy automating!

HtmlUnit Remote: Acquiring Remote HtmlUnitDriver Session in Selenium 4 Grid

This post describes ‘HtmlUnit Remote’, a wrapper for HtmlUnitDriver that enables Selenium 4 Grid to manage remote instances of this “headless” browser.

HTMLUNIT REMOTE

Maven Central

The HtmlUnit Remote project implements a W3C WebDriver protocol wrapper for HtmlUnitDriver, which enables Selenium 4 Grid to supply remote sessions of this headless browser.

Background

To eliminate behavioral differences between local and remote configurations, the Selenium Foundation framework always acquires browser sessions from a Grid instance, managing its own local grid instance when not configured to use an existing grid. Selenium 3 Grid could be configured to supply HtmlUnitDriver sessions, supported by special-case handling within the Node server itself. This handling was not carried over into Selenium 4 Grid, which was completely re-engineered with new architecture and vastly expanded capabilities.

The lack of HtmlUnitDriver support in Selenium 4 Grid necessitated reconfiguring the Selenium Foundation project unit tests from using this Java-only managed artifact to using a standard browser like Chrome, an external dependency that requires additional resources and imposes additional risks of failure.

The driver service implemented by HtmlUnit Remote enables Selenium 4 Grid to supply HtmlUnitDriver sessions.

Project Rationale

My initial objective for creating HtmlUnit Remote was to retain feature parity in Selenium Foundation for the set of browsers supported with Selenium 3 and Selenium 4. Although I could configure my unit tests to target a conventional browser, I also wanted to avoid additional external dependencies with associated risks.

Once I began investigating the features and functionality I would need to enable Selenium 4 Grid to supply HtmlUnitDriver sessions, I recognized an additional benefit this project could provide - comprehensive standardized configurability.

HtmlUnitDriver Configuration

All remote drivers are configured via a standard Selenium feature - the Capabilities object. Prior to the HtmlUnit Remote project, many of the options of HtmlUnit could not be accessed or modified via the Capabilities API. These were only available via custom HtmlUnitDriver methods, and the way that non-standard capabilities had been added to the Capabilities object didn’t conform to the W3C specification.

This meant that the initial phase of the HtmlUnit Remote project was to implement a comprehensive W3C-compliant configuration object - the HtmlUnitDriverOptions class. This class extends AbstractDriverOptions, adding driver-specific capabilities under an extension named garg:htmlunitOptions. Support for this class provides full configurability of all HtmlUnitDriver options through the standard Capabilities API.

This standardized configuration API has been incorporated directly into HtmlUnitDriver, providing the core implementation for manipulating every driver setting. To maintain backward compatibility, all of the existing constructors and configuration methods have been retained, reimplemented to use this new core API.

W3C Remote Protocol Wrapper

With full standardized configurability in place, the next step was to create a server that implements the W3C WebDriver protocol. The HtmlUnitDriverServer functions as a remote protocol wrapper around one or more HtmlUnitDriver sessions, performing the following tasks:

  • Create and manage driver sessions
  • Route driver commands to specified driver sessions
  • Package driver method results into HTTP responses

HtmlUnit Remote Packaging

Rather than bulk up the existing driver with remote-specific features, HtmlUnitDriverServer and associated facilities are packaged in a companion htmlunit-remote artifact. In addition to the server, this artifact defines a driver information provider (HtmlUnitDriverInfo), a driver service (HtmlUnitDriverService), and a custom slot matcher (HtmlUnitSlotMatcher).

Connecting to the Grid

Next up is HtmlUnitDriverInfo, which specifies the basic characteristics of the driver and provides a method that creates a driver session with specified capabilities. This class implements the standard WebDriverInfo interface.

With availability of HtmlUnitDriver advertised by this information provider, Selenium 4 Grid nodes can be configured to provide driver sessions:

htmlunit.toml
[node]
detect-drivers = false
[[node.driver-configuration]]
display-name = "HtmlUnit"
stereotype = "{\"browserName\": \"htmlunit\"}"

[distributor]
slot-matcher = "org.openqa.selenium.htmlunit.remote.HtmlUnitSlotMatcher"

The selenium-server JAR doesn’t include the HtmlUnitDriver artifacts; these need to be specified as extensions to the grid class path via the --ext option:

java -jar selenium-server-<version>.jar --ext htmlunit-remote-<version>-grid-extension.jar standalone --config htmlunit.toml

The grid-extension artifact provides all of the specifications and service providers required to enable Selenium 4 Grid to supply remote sessions of HtmlUnitDriver. This artifact combines htmlunit-remote with htmlunit3-driver, htmlunit, and all of their unique dependencies.

Implementation Details

HtmlUnit Remote provides the following elements:

  • HtmlUnitDriverInfo - This class informs Selenium 4 Grid that HtmlUnitDriver is available and provides a method to create new driver instances.
  • HtmlUnitSlotMatcher - This custom slot matcher extends DefaultSlotMatcher, indicating a match if both the slot stereotype and requested browser capabilities specify htmlunit as the browser name.
  • HtmlUnitDriverService - This class manages a server that hosts instances of HtmlUnitDriver.
  • HtmlUnitDriverServer - This is the server class that hosts HtmlUnitDriver instances, enabling remote operation via the W3C WebDriver protocol.

In operation, HtmlUnitDriverService is instantiated by Selenium 4 Grid node servers that are configured to support HtmlUnitDriver. Unlike other driver services, which launch a new process for each created driver session, HtmlUnitDriverService starts a single in-process server that hosts all of the driver sessions it creates.

This is a guest blog post by Scott Babcock

Two Chrome features you should disable

This blog post lists two problematic Chrome features that can affect your automation as well as a quick way to disable them.

Search engine selection screen

Starting with version 127 of Chrome, the browser now asks which search engine you would like to use, which is great for regular users.

But for automation, it does so every single time.

To bypass this, use the argument below when specifying the browser options.

--disable-search-engine-choice-screen

Chrome wastes over 60MB of your bandwidth downloading language plugins

The second feature is something that has been with Chrome for quite a while now.

Every time you launch Chrome, it will query and download several .crx files.

These files can even be left over on your disk’s download folder if you create and close drivers faster than these can be processed.

To disable this feature, use the browser option below.

--disable-features=OptimizationGuideModelDownloading,OptimizationHintsFetching,OptimizationTargetPrediction,OptimizationHints

This is a guest blog post by Marek Andreansky

Welcoming Puppeteer to the WebDriver World

Puppeteer has moved over to support WebDriver BiDi getting full support in Chromium browsers and Firefox.

The Selenium Project has always been fully supportive of creating a standard to improve the quality of the web that we use. We started with the WebDriver Specification and over the last couple of years have been working with the Safari, Edge, Chrome, and Firefox teams on the WebDriver-BiDi specification.

Today, we are celebrating that Puppeteer has moved over to using WebDriver-BiDi, the new WebDriver Specification that allows WebDriver clients to have event driven APIs instead of the synchronous way Selenium has done it before.

This new protocol allows us to be able to do things Selenium always wanted to do but was never surfaced to us in a meaningful way. We have documented all the latest additions to Selenium, thanks to WebDriver-BiDi, in our documentation

You can read about the latest changes on Mozilla Hacks and on the Chrome Developer Blog.

Congratulations to everyone in making this a reality and supporting a standardised web!

Protecting unsecured Selenium Grids against SeleniumGreed

With an ongoing attack, called SeleniumGreed, on Selenium Grids, we recommend you keep your grid secure.

Over the last week there have been stories going around about crypto miners abusing unsecured Selenium Grids by injecting code in the session create to download and start up crypto miners. This came out thanks to the work from Wiz about an attack they have called SeleniumGreed. This issue can be abused on most versions of Selenium but there appears to be a lot of effort going into abusing Selenium Grid 3.14. Please upgrade as some of the security items have been added since then.

Selenium Grid by default doesn’t have any authentication as the assumption has always been that we want you to put this behind a secure network to prevent people from abusing your resources. There are ways that you can secure the grid, and we have documentation available on how to do this in our help section. You can see more details if you run

java -jar selenium-server-<version>.jar info security

Another way to combat this is to use a cloud provider to run your Selenium Grid. We have numerous vendors that sponsor us so have a look at our sponsors page. If you need help, after reading the help section please come into our chat rooms and we will try guide you through making your grid more secure.

Selenium 4.23 Released!

Today we’re happy to announce that Selenium 4.23 has been released!

We’re very happy to announce the release of Selenium 4.23.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Noteworthy changes per language

  • Java
    • Add custom duration for Actions constructor (#14085).
    • Set session-request-timeout as client readTimeout in RemoteNewSessionQueue.
    • Add high-level BiDi logging APIs.
    • See all changes

  • JavaScript
    • Add source type to BiDi log entry.
    • Add high-level script pinning BiDi APIs.
    • See all changes

  • .NET
    • Log http requests/responses via internal DiagnosticsHttpHandler.
    • Return protected synchronous Execute method in WebDriver.
    • See all changes



Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Agustin Pequeno

Agustin Pequeno

Selenium Docs & Website

ian zhang

ian zhang

Agustin Pequeno

Agustin Pequeno

Docker Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Werner Robitza

Werner Robitza

Sebastian Schreck

Sebastian Schreck

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy automating!

Sauce Labs: A New Milestone with Selenium

Announcing a new Development partnership tier with Sauce Labs, celebrating our supporters!

Selenium has witnessed an exceptional year filled with expansion and progress. The rising popularity of Selenium’s Python Bindings is prominently showcased through the engaging discussions at the Selenium Conference and on LinkedIn. Concurrently, the Java bindings have reached a significant landmark, surpassing 100 million downloads. In addition to this, the community has managed to garner over 2.5 million active Selenium users monthly.

We could not have achieved Selenium’s 20th anniversary without the collective efforts of numerous volunteers and the invaluable assistance of a company like Sauce Labs.

In 2008, Jason Huggins, Selenium’s creator, established Sauce Labs, a company that has since played a crucial role in Selenium’s expansion.

Sauce Labs has provided a platform for the Selenium Project to display its accomplishments, including various keynotes at SauceCon. Here, figures like Simon Stewart and Jim Evans have been able to share their visions for the future of Selenium.

Financially, Sauce Labs has substantially supported the Selenium Project, sponsoring both the project itself and the Selenium Conference over many years. This backing has been instrumental in allowing the project to flourish.

Selenium thrives on collaboration, and Sauce Labs has been a vital facilitator. They have enabled the Selenium Project to host in-person events like the Test Automation Summit in Berlin in 2022. These gatherings have provided opportunities for members of the Selenium Project to engage with creators of different testing frameworks, fostering discussions on ecosystem improvements. Sauce Labs has also hosted Selenium Dev Summits, where the project’s future has been a central topic.

Sauce Labs contributions extend beyond financial support. They have significantly contributed to the technical and organizational well-being of the Selenium Project. Boni Garcia developed the first version of Selenium Manager while at Sauce Labs. Furthermore, several Sauce Labs employees, including Marcus Merrell, Diego Molina, and Titus Fortner, continue contributing to the Selenium project, driven by their passion. This passion is shared by Sauce Labs, enabling these contributions to be part of their daily work.

This unwavering support has nurtured a project governed openly, not by a single entity, but by the community. This model has welcomed diverse contributors, including Google Chrome, Microsoft, Apple, LambdaTest, Applitools, BrowserStack, and Mozilla Firefox teams. Together, they have developed WebDriver BiDi, the next generation of WebDriver.

The project’s open governance and collaborative nature have allowed continuous work on client bindings, particularly WebDriver BiDi, community support, documentation improvements, and maintenance of additional projects.

Sauce Labs has been an unnamed development partner for the Selenium Project for many years. With this in mind, the Selenium Project now shows its appreciation to Sauce Labs for their years of continued support by creating a new sponsorship tier called the Development Partner and naming Sauce Labs the first and official Development Partner.

Sauce Labs has Selenium in its DNA, and Selenium has Sauce Labs in its DNA. This partnership celebrates their shared history and future. We are excited to see what the future holds for both Selenium and Sauce Labs, and we are excited to continue to work together for the next twenty years.

If you want to learn more about this partnership and win a limited edition t-shirt, check How Did Sauce Labs Get Its Name? A Selenium Story.

Celebrating a Milestone: BrowserStack Becomes Selenium's Development Partner

Selenium is proud to annouce that we have created a new tier to show the appreciation of the companies that support us.

It has been a great year for the Selenium community as it continues to grow. The popularity of Selenium’s Python Bindings is evident from the discussions at the Selenium Conference and on LinkedIn, while the Java bindings have impressively surpassed 100 million downloads.

This project, having reached 20 years old this year, would not be possible without the amazing contributions from our volunteer contributors and the Open Source Program Offices of companies like BrowserStack that allow us to work on this project as part of our day jobs.

About BrowserStack They have over 50,000 organizations and 6M users using their end-to-end testing platform. BrowserStack has been one of the Selenium project’s biggest supporters for years and currently employs several of Selenium’s core maintainers, donating a significant portion of their time towards the development, maintenance, support, and leadership of open-source Selenium repos.

This dedicated support has allowed us to continue work on the client bindings, especially the work going into WebDriver BiDi, support our community, continuously improve our documentation, and maintain all the extra projects we oversee, ensuring Selenium can continue to thrive for the next 20 years. We are also thrilled to highlight the collaborative efforts between the BrowserStack team, the Google Chrome team, Microsoft, Apple, SauceLabs, and the Firefox team, who have come together to build Selenium WebDriver BiDi, the next generation of Selenium. This collaborative spirit embodies our dedication to enhancing the testing experience for the Selenium user community. With this in mind, the Selenium Project now shows our appreciation to BrowserStack for their years of continued support by creating a new sponsorship tier called the Development Partner. We are deeply indebted to BrowserStack for all their support and are proud to recognize them as our first official Development Partner. This work has allowed us to continue progress on the client bindings, especially the work going into WebDriver BiDi, support our community, continuously improve our documentation, and maintain all the extra projects we oversee, so Selenium can continue to be around for the next 20 years!

Selenium 4.22 Released!

Today we’re happy to announce that Selenium 4.22 has been released!

We’re very happy to announce the release of Selenium 4.22.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Highlights

  • Selenium has at least 2.6 active users in the last 30 days. 200k more than last month!
    • All information we collect is publicly available.
    • The numbers only represent users who have Selenium Manager enabled and are using Selenium v4.17 or greater.
    • Python, Chrome and Windows all see the majority of use.
  • Chrome DevTools support is now: v124, v125, and v126 (Firefox still uses v85 for all versions)
  • The first implementations of the new BiDi API have rolled out in Ruby, Python and JavaScript

Noteworthy changes per language

  • Java
    • Enabling BiDi can now be accomplished by calling enableBiDi() on an Options class instance.
    • Video file name in Dynamic Grid can be set with se:videoName capability.
    • See all changes

  • JavaScript
    • BiDi API for console logging and JavaScript errors has been implemented.
    • Additional BiDi implementations.
    • See all changes

  • .NET
    • The .NET bindings have started to roll out asynchronous methods.
      • The synchronous methods will still be supported, but they will call the async methods “under the hood.”
      • This release adds asynchronous methods to the Navigation class.
    • See all changes

  • Python
    • This release implements a new way of working with Chrome Devtools Protocol
      • The previous implementation requires async/await pattern, so it was not backwards compatible.
      • The new implementation is backwards compatible and executes async code in separate threads.
    • Updated the webkitgtk and wpewebkit driver implementations.
    • Enabling BiDi can now be accomplished by setting the enable_bidi() property of an Options class instance to True.
    • BiDi API for console logging and JavaScript errors has been implemented.
    • See all changes

  • Ruby
    • Implemented a toggle for BiDi and Classic implementations.
    • BiDi API for console logging and JavaScript errors has been implemented.
    • See all changes

  • Rust
    • Added the ability to stream logging information to stdout instead of after execution complete.
    • Improved binary location on Windows with native Rust methods.
    • See all changes

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Agustin Pequeno

Agustin Pequeno

Alexander Millin

Alexander Millin

Scott Babcock

Scott Babcock

Vladislav Velichko

Vladislav Velichko

James Yuzawa

James Yuzawa

Selenium Docs & Website

ian zhang

ian zhang

Agustin Pequeno

Agustin Pequeno

Sang Nguyen

Sang Nguyen

Docker Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy automating!

Multi-Arch Images via Docker Selenium

This blog post announces the availability of Multi-Arch Images for Selenium Grid Server on the official Selenium Docker Hub registry.

We’re very happy to announce the landing of Multi-Arch Images for Selenium Grid Server on the Selenium Docker Hub registry!

Motivation

For experimental Docker container images that are able to run on platforms such as the Apple M-series or Raspberry Pi, the community-driven repository initiative hosted at SeleniumHQ-Community/docker-seleniarm. These images are built for separate architectures: linux/arm64 (aarch64), linux/arm/v7 (armhf), and linux/amd64 and published on Seleniarm Docker Hub registry.

In order to bring more awareness to the existence of the Multi-Arch Docker container images, provide more insight and transparency on how the container images are built, as well as overcome challenges in building and maintaining them. We have decided to merge the fork into the main project Docker Selenium and published multi-arch images on Selenium Docker Hub registry.

Overview

From image tag releases 4.21.0 onwards, the architectures supported by Docker Selenium as below

ArchitectureOperating SystemAvailable
x86_64 (aka amd64)Ubuntu LTS
aarch64 (aka arm64/armv8)Ubuntu LTS
armhf (aka arm32/armv7l)N/A

Based on the architecture of the host machine, Docker will automatically pull the correct image for the platform.

Browser Binaries

Let’s take a moment to look at the browser binaries which are available for various architectures

Google does not build Chrome (google-chrome) for Linux/ARM platforms. Hence, the Chrome (node and standalone) images are only available for AMD64. Similarly, Microsoft does not build Edge (microsoft-edge) for Linux/ARM platforms.

Instead, the open source Chromium browser is used in place of Chrome and Edge. The standalone-chromium and node-chromium

$ docker run --rm -it -p 4444:4444 -p 5900:5900 -p 7900:7900 --shm-size 2g selenium/standalone-chromium:latest

Mozilla Firefox now is available for Linux/ARM64 via Nightly channel. The Firefox version in the ARM64 image will be different from the AMD64 version until the stable release is available.

Image NameOperating Systemamd64arm64
standalone-chromiumUbuntu LTS
node-chromiumUbuntu LTS
standalone-firefoxUbuntu LTS
node-firefoxUbuntu LTS
standalone-edgeUbuntu LTS
node-edgeUbuntu LTS
standalone-chromeUbuntu LTS
node-chromeUbuntu LTS

Build, test, and distribute multi-arch images

We would also like to share what has been done to ensure that the multi-arch images can be built, tested, and distributed seamlessly.

  • Utilize Bash scripts and Makefile to wrap the tasks as much as possible. It provides the transparency on how the container images are built and proceed by single command.

  • Utilize Arm VM’s support on CircleCI to build, test, and deploy ARM64 images. Once GitHub Actions officially supports Arm-based hosted runners, those workflows can easily be moved back to the same place. All the tests done for AMD64 images (including Docker, Docker Compose, and deploy to Kubernetes) are used to verify ARM64 images.

  • Utilize experimental feature containerd image store in Docker Engine to build and distribute multi-arch images in a simple way.

Hopefully, this will make it easy for the community to find and use multi-arch images to simplify Selenium Grid Server deployment on various platforms.


Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy testing!

Selenium 4.21 Released!

Today we’re happy to announce that Selenium 4.21 has been released!

We’re very happy to announce the release of Selenium 4.21.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Highlights

  • Chrome DevTools support is now: v123, v124, and v125 (Firefox still uses v85 for all versions)
  • Selenium has at least 2.4M active users in the last 30 days. 100k more than last month!
    • India and United States are the top countries with the most users.
    • Python is the most used language from the last 5 releases.
    • The most used operating system is Windows, with at least 1.9M users.
  • Extensibility points started to be implemented to simplify the integration between Selenium and Appium. Ruby is the first language to implement it.
  • Java and JavaScript keep adding more WebDriver BiDi features.
  • In Java, it is possible to set parameters for Selenium Manager via system properties.
  • Nightly packages are tested daily with the examples from the Selenium documentation.

Noteworthy changes per language

  • Java
    • Browser containers provisioned in Dynamic Grid will use the hostConfig
    • Set test name to video file name in Dynamic Grid
    • See all changes

  • JavaScript
    • Ensure selectVisibleByText method is same as other languages
    • See all changes


  • Python
    • Moving ignore_local_proxy_environment_variables to BaseOptions
    • See all changes


Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Joe Bandenburg

Joe Bandenburg

Oleksandr Kulychok

Oleksandr Kulychok

Sandeep Suryaprasad

Sandeep Suryaprasad

Selenium Docs & Website

Agustin Pequeno

Agustin Pequeno

Chamila Ambahera

Chamila Ambahera

Docker Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

Puja Jagani

Puja Jagani

Diego Molina

Diego Molina

Boni García

Boni García

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

David Burns

David Burns

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy testing!

Selenium 4.20 Released!

Today we’re happy to announce that Selenium 4.20 has been released!

We’re very happy to announce the release of Selenium 4.20.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Highlights

  • Chrome DevTools support is now: v122, v123, and v124 (Firefox still uses v85 for all versions)
  • Selenium has at least 2.3M active users in the last 30 days. 500k more than last month!
  • Java and JavaScript keep adding more WebDriver BiDi features.
  • .NET C# and JavaScript now publish nightly builds to GitHub packages.
  • Nightly packages are tested daily with the examples from the Selenium documentation.
  • The code used to invoke Selenium Manager has been refactored in all languages, making it easier to maintain and improve.
    • The interface has changed and if users were invoking it, they might experience issues. Selenium Manager is still in beta and these type of changes are expected.

Noteworthy changes per language

  • Java
    • Browser containers provisioned in Dynamic Grid will use the hostConfig
    • Dynamic Grid re-fetches browser images if they were pruned during runtime
    • Several BiDi additions: Update browsing context create method, between others.
    • See all changes

  • JavaScript
    • Several BiDi additions: Update capture screenshot APIs to include all parameters and remove scroll parameter, between others
    • Nightly JS builds are now pushed to GitHub packages
    • See all changes

  • .NET
    • The correct devtools session id is now used after reinitialization
    • Nightly .NET C# builds are now pushed to GitHub packages
    • See all changes



Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Selenium Docs & Website

Viet Nguyen Duc

Viet Nguyen Duc

Agustin Pequeno

Agustin Pequeno

Harshit Bhardwaj

Harshit Bhardwaj

Andrew Zipperer

Andrew Zipperer

Docker Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Maxim Manuylov

Maxim Manuylov

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

Puja Jagani

Puja Jagani

Diego Molina

Diego Molina

Boni García

Boni García

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

David Burns

David Burns

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy testing!

Selenium 4.19 Released!

Today we’re happy to announce that Selenium 4.19 has been released!

We’re very happy to announce the release of Selenium 4.19.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Highlights

  • Chrome DevTools support is now: v121, v122, and v123 (Firefox still uses v85 for all versions)
  • Thanks to Selenium Manager’s records usage, we know Selenium has at least 1.8M active users in the last 30 days!
  • Java and JavaScript keep adding more WebDriver BiDi features.
  • The WebDriver BiDi features in Java have a new home, read it at Puja’s blog post.

Noteworthy changes per language

  • Java
    • se:bidi was removed from the session response when starting a Grid session, as webSocketUrl is enough.
    • Memory allocation and thread handling was improved in Grid.
    • Add missing event handlers for TargetLocator interface in WebDriverListener.
    • Several BiDi additions: adding setFiles command of the Input Module, between others.
    • See all changes

  • JavaScript
    • Several BiDi additions: adding setFiles command of the Input Module, between others.
    • See all changes

  • .NET
    • The ChromiumDriverService.AllowedIPAddresses name was corrected
    • It is now possible to set timeouts via capabilities
    • See all changes

  • Python
    • More network interfaces were added to detect lan ip
    • The install_addon() (Firefox extensions) was improved to take into account dir paths with trailing slashes
    • Improvements for type parameters
    • See all changes


  • Rust
    • Improving how MS Edge is downloaded
    • Fix how MS Edge is managed in RPM-based Linux
    • See all changes

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Adam Dangoor

Adam Dangoor

Agustin Pequeno

Agustin Pequeno

Scott Babcock

Scott Babcock

Jani Hautakangas

Jani Hautakangas

Selenium Docs & Website

Amar Deep Singh

Amar Deep Singh

Mohammad Monfared

Mohammad Monfared

Docker Selenium

Viet Nguyen Duc

Viet Nguyen Duc

Cedric Roijakkers

Cedric Roijakkers

Maxim Manuylov

Maxim Manuylov

Mårten Svantesson

Mårten Svantesson

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

Puja Jagani

Puja Jagani

Diego Molina

Diego Molina

Boni García

Boni García

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

David Burns

David Burns

Stay tuned for updates by following SeleniumHQ on X (Formerly Twitter) or LinkedIn!

Happy testing!

Update imports to use BiDi Java

This blog post discusses the rationale behind the breaking change in Java BiDi implementation and the changes users will have to make.

What part of the code base is impacted?

Selenium WebDriver BiDi APIs in Java bindings are impacted.

What is impacted by the breaking change?

The WebDriver BiDi APIs stay as they are, so you can continue to use them. However, the import statements need to be updated.

What is the breaking change?

The import statements need to be updated when using the BiDi APIs.

Before Selenium 4.19:

import org.openqa.selenium.bidi.LogInspector;
import org.openqa.selenium.bidi.BrowsingContextInspector;
import org.openqa.selenium.bidi.Input;
import org.openqa.selenium.bidi.Script;
import org.openqa.selenium.bidi.Network;

After Selenium 4.19 and above:

import org.openqa.selenium.bidi.module.LogInspector;
import org.openqa.selenium.bidi.module.BrowsingContextInspector;
import org.openqa.selenium.bidi.module.Input;
import org.openqa.selenium.bidi.module.Script;
import org.openqa.selenium.bidi.module.Network;

Why the breaking change?

Selenium is actively working to implement the W3C BiDi. The long-term goal of W3C BiDi is to port all W3C WebDriver Classic APIs to use the WebDriver BiDi APIs under the hood. When browsingContext.locateNodes command, which is the BiDi counterpart of findElements command, was introduced, the major goal was to ensure that the ’locateNodes’ command returns a WebElement. This would be make the porting smoother in the future and allows users to continue calling APIs of the WebElement.

During the implementation, a circular dependency was encountered in the underlying build tool Bazel. The solution to this was to follow the best practices of Bazel.

So, the W3C BiDi related classes of a module were grouped into Bazel package. The classes that themselves call commands or events were all grouped under a package named ‘module’. Thus, following the recommended practice and avoiding Bazel’s circular dependency proved to be a win-win solution.

Summary

The W3C BiDi protocol is in under development, and parallelly browsers and clients are working to add the complementary APIs. While Selenium works on implementing it, the protocol is constantly changing, with new modules or APIs being added or existing ones being updated. While the team strives to avoid breaking changes and deprecate APIs for at least 2 versions before removal, it can be challenging to adhere to this for some changes, such as the one described in this blog post.

Selenium 4.18 Released!

Today we’re happy to announce that Selenium 4.18 has been released!

We’re very happy to announce the release of Selenium 4.18.0 and 4.18.1 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Highlights

  • Chrome DevTools support is now: v120, v121, and v122 (Firefox still uses v85 for all versions)
  • Selenium Manager records usage has been decreased to reduce impact on users.
  • Chrome headless changed the name of the browser to reflect that it is not actually chrome; Selenium now handles this seamlessly, but you should still switch to --headless=new (see: Headless is going away)

Noteworthy changes per language

  • Java
    • Enabling Grid to use self-signed certificate for debugging
    • Added explicit target locator events to the listener support classes in WebDriverListener.
    • Add missing event handlers for TargetLocator interface in WebDriverListener.
    • Several BiDi additions: Browsing context destroyed event, Network intercept commands, command continuewithAuth, between others.
    • See all changes

  • JavaScript
    • Several BiDi additions: Browsing context destroyed event, realm destroyed event, command continuewithAuth, between others.
    • See all changes

  • .NET
    • Fix protocol cdp version for RemoteWebDriver.
    • Fix network response data encoding.
    • Explicitly support passing the full path to driver in Service constructor
    • See all changes



  • Rust
    • Add timestamps to Selenium Manager logs
    • Selenium Manager decreases frequency of statistics reporting
    • See all changes

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Manuel Blanco

Manuel Blanco

Oleg Ridchenko

Oleg Ridchenko

Simon Perepelitsa

Simon Perepelitsa

Simon K

Simon K

Valery Yatsynovich

Valery Yatsynovich

Selenium Docs & Website

Michal Nowierski

Michal Nowierski

Mohammad Monfared

Mohammad Monfared

我的饭

我的饭

Nikolay Borisenko

Nikolay Borisenko

Docker Selenium

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Simon Stewart

Simon Stewart

Titus Fortner

Titus Fortner

Stay tuned for updates by following SeleniumHQ!

Happy testing!

Selenium 4.17 Released!

Today we’re happy to announce that Selenium 4.17 has been released!

We’re very happy to announce the release of Selenium 4.17.0 for Javascript, Ruby, Python, .NET, Java and the Grid! Links to everything can be found on our downloads page.

Highlights

  • Chrome DevTools support is now: v119, v120, and v121 (Firefox still uses v85 for all versions)
  • Selenium Manager records usage set environment variable SE_AVOID_STATS to "true" to avoid sending information.
  • Chrome headless changed the name of the browser to reflect that it is not actually chrome; Selenium now handles this seamlessly, but you should still switch to --headless=new (see: Headless is going away)

Noteworthy changes per language

  • Java
    • Remove deprecated event listener classes; update to EventFiringDecorator and WebDriverListener classes
    • Allow disabling Grid UI
    • Deprecated FirefoxBinary class and legacy Error Codes
    • Deprecated HTML5 features for offline storage, location, and network connection
    • No longer accepting session requests with desiredCapabilities keyword
    • See all changes

  • JavaScript
    • Remove deprecated headless methods and associated references
    • Implemented remote file downloading
    • See all changes

  • .NET
    • Improvements to the new logging implementation
    • Removed previously deprecated code
    • See all changes

  • Python
    • Updated WPEWebKit support
    • Removed previously deprecated code
    • Deprecated FirefoxBinary and several outdated FirefoxProfile methods
    • See all changes


  • Rust
    • Use latest browser from cache when browser path is not discovered
    • Throw a descriptive message when error parsing JSON from response
    • See all changes

Contributors

Special shout-out to everyone who helped the Selenium Team get this release out!

Selenium

Andrei Solntsev

Andrei Solntsev

James Braza

James Braza

Lauro Moura

Lauro Moura

Valery Yatsynovich

Valery Yatsynovich

Viet Nguyen Duc

Viet Nguyen Duc

Henrik Skupin

Henrik Skupin

Selenium Docs & Website

Yevgeniy Shunevych

Yevgeniy Shunevych

Docker Selenium

Auto81

Auto81

Amar Deep Singh

Amar Deep Singh

Viet Nguyen Duc

Viet Nguyen Duc

Selenium Team Members

Thanks as well to all the team members who contributed to this release:

David Burns

David Burns

Boni García

Boni García

Diego Molina

Diego Molina

Sri Harsha

Sri Harsha

Nikolay Borisenko

Nikolay Borisenko

Alex Rodionov

Alex Rodionov

Puja Jagani

Puja Jagani

Titus Fortner

Titus Fortner

Stay tuned for updates by following SeleniumHQ!

Happy testing!

Selenium Vs … blog posts

This blog post discusses the click bait posts out there comparing selenium, cypress, and playwright. How none of these are meaningful or helpful.

The easiest way to clickbait a blog post about automated testing is to compare Selenium against another tool in the space with a catchy title especially when it talks down about the incumbent.

Unfortunately, this can lead to muddying the waters of which features are available in any of the products out there especially when we compare apples to apples.

Selenium has always been a great tool for browser automation. Fortunately for the project, it has become the tool of choice for testing web applications for nearly 2 decades. The area this project has focused on is building out the hard parts of browser automation that are increasingly difficult. Stable APIs and scalability of the infrastructure to run Selenium has always been the priority of the project. It hasn’t focused on how people test with it because there are very good test frameworks out there and having to do it for 5 different languages is a non-trivial amount of engineering effort.

However, some particular misconceptions regularly reappear across these blog posts.

It’s too hard to set up browsers and drivers compared to Playwright and Cypress

This used to be true in the past as you had to download the drivers. This wasn’t too bad for GeckoDriver and SafariDriver as they could handle browser upgrades gracefully. On the other hand, you need to update the drivers for Chromium-based browser for every new release.

For over a year now, Selenium handles this automatically. If it can’t find a ChromeDriver or EdgeDriver, it will download it using Selenium Manager. Since its first release it has improved a lot and it is now probably the best in class since the latest versions of Selenium will even download browsers if it can and use that. Compared to Playwright and Cypress you don’t need to update your dependency on Selenium to update browsers and drivers, you still use the same browsers as your customers, and switching versions becomes a breeze: you don’t also have to change the test framework you’re using. And, let’s not forget that it uses the browser that Google recommends you use for testing.

Setting up a test runner is hard work where Playwright and Cypress have it built in…

Well… maybe? Setting up E2E test frameworks with Selenium isn’t as difficult as some might suggest. The hard part really is making sure that the driver is in the right place and we’ve solved that as discussed above. Once that’s done, Selenium’s approach allows you to use whichever test runner you’re most comfortable with. If you’d like a “batteries included” approach, with Selenium tightly integrated with the test runner, then one of the many projects that use Selenium, such as SeleniumBase, Nightwatch, Serenity, and so on, might be the right tool for you.

One thing to note is that Playwright is the only multi-language browser automation framework like Selenium. However, if you don’t use TypeScript or JavaScript you will still need to do the setup of the test runner yourself. Some testing frameworks have plugins that automatically set up the fixtures you might need. In the JavaScript/TypeScript space if you really need a built-in test runner there are downstream projects like NightwatchJS and tangential projects like WebdriverIO. Downstream projects use our libraries and tangential projects have their own libraries but still follow the WebDriver standard.

Playwright and Cypress can do network interception and allow me to write event-driven code unlike Selenium

Selenium has been able to offer this since Selenium 4 came out. It’s so good that even Playwright suggest you use it for scaling your tests. The Selenium Project won’t be removing this anytime soon as we are dependent on WebDriver BiDi specification being implemented for those features to replace them. Even then Selenium has a history of trying to make sure that upgrades don’t break anything without sufficient warning. It’s why each language provides high-level wrappers, such as the NetworkInterceptor, that isolate your tests from the underlying technology being used.

Summary

As we have seen from the above Selenium is still as good as the products out there. One thing that is different for Selenium from Cypress or Playwright is that we’re a volunteer-driven project and not commercially backed. Want to help us out? Why not write a blog post about how you’re using the features above or post on social media how these features make your lives easier?