selenium-webdriver 4.40.0 → 4.41.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6ba40ae3f831d1c9a379d4799c59226f2edf5a0c6429b8cb55a8e95daed84231
-  data.tar.gz: b03c61460a257c5d028575607a59e41819b17e2baf47308e19086cd7194b70d5
+  metadata.gz: d3f3769c3f06d18f04b2c853d6d8bbce6a8f5a65dc125cf6e6e654255165ae4d
+  data.tar.gz: e410cd9baf19d27129da632a1ca7056ec286ed887dae207c9d20b8ec0c98dc61
 SHA512:
-  metadata.gz: 0ac2c28f5f6c9006fee5bd5f59f8099596cb9773c42f40498ffa03bf9ede46bc1255cd1cdbdbb72ed6af9721c3e68987feb39859732ade34bed6f3dd94251d4c
-  data.tar.gz: f98a8768f75757c2b35a296b5c4f2e4dd4e64d864c4e05b1399695246919047c2cd5cfb8baf4f668efae584afafeda948db17743f9c6baecf5b9959bb6ff6df7
+  metadata.gz: 7ffadd3dd7dd1be1746c0577c6ffe335637b6e9ff34ae8d81b07edad4cb5a6c279d4a05ffe9aeadf0ef6cb3d68da8469213fe2163a00d896c49bb0bf8e05bf6c
+  data.tar.gz: a703ea20b011cd8c3ee5016e58ea4671a88698d434f5f7dc6a32b3cdcc55c3e9a25425c379194e4577873a316626cab8487d40077a372fa9d78759939c1e70ce

data/CHANGES

@@ -1,3 +1,13 @@
+4.41.0 (2026-02-19)
+=========================
+* Support CDP versions: v143, v144, v145
+* remove stored atoms these get generated by build (#16971)
+* output driver logs when SE_DEBUG is enabled (#16901)
+* Update lint configuration and fix rubocop offenses (#17008)
+* add missing unit tests (#17025)
+* [grid] Add session event API for server-side event bus integration (#17015)
+* Update dependencies (#17111)
+
 4.40.0 (2026-01-18)
 =========================
 * add synchronization and error handling for socket interactions (#16487)

data/lib/selenium/webdriver/bidi/network/cookies.rb

@@ -27,10 +27,13 @@ module Selenium
       class Cookies < Hash
         def as_json
           map do |name, val|
-            self[:name] = name.to_s
-            self[:value] = {type: 'string', value: val.to_s}
-
-            [compact]
+            {
+              name: name.to_s,
+              value: {
+                type: 'string',
+                value: val.to_s
+              }
+            }
           end
         end
       end

data/lib/selenium/webdriver/chrome/service.rb

@@ -26,6 +26,16 @@ module Selenium
         SHUTDOWN_SUPPORTED = true
         DRIVER_PATH_ENV_KEY = 'SE_CHROMEDRIVER'
 
+        def initialize(args: nil, **)
+          if ENV.key?('SE_DEBUG')
+            args = Array(args.dup)
+            warn_driver_log_override if args.reject! { |arg| arg.include?('log-level') || arg.include?('silent') }
+            args << '--verbose'
+          end
+
+          super
+        end
+
         def log
           return @log unless @log.is_a? String
 

data/lib/selenium/webdriver/common/child_process.rb

@@ -24,7 +24,8 @@ module Selenium
     #
 
     class ChildProcess
-      TimeoutError = Class.new(StandardError)
+      class TimeoutError < StandardError
+      end
 
       SIGTERM = 'TERM'
       SIGKILL = 'KILL'

data/lib/selenium/webdriver/common/driver_extensions/has_session_events.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Licensed to the Software Freedom Conservancy (SFC) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module DriverExtensions
+      module HasSessionEvents
+        #
+        # Fires a custom session event to the remote server event bus.
+        # This allows test code to trigger server-side utilities that subscribe to
+        # the event bus.
+        #
+        # @param [String] event_type The type of event (e.g., "test:failed", "log:collect")
+        # @param [Hash] payload Optional data to include with the event
+        # @return [Hash] Response data including success status, event type, and timestamp
+        #
+        # @example Fire a simple event
+        #   driver.fire_session_event("test:started")
+        #
+        # @example Fire an event with payload
+        #   driver.fire_session_event("test:failed", {
+        #     testName: "LoginTest",
+        #     error: "Element not found"
+        #   })
+        #
+        def fire_session_event(event_type, payload = nil)
+          @bridge.fire_session_event(event_type, payload)
+        end
+      end # HasSessionEvents
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/common/logger.rb

@@ -55,9 +55,32 @@ module Selenium
         @ignored = Array(ignored)
         @allowed = Array(allowed)
         @first_warning = false
+        @level_forced = false
+        @output_forced = false
+      end
+
+      #
+      # Forces debug level and prevents it from being overridden.
+      #
+      def debug!
+        @level_forced = true
+        @logger.level = :debug
+      end
+
+      #
+      # Forces output to stderr and prevents it from being overridden.
+      #
+      def stderr!
+        @output_forced = true
+        @logger.reopen($stderr)
       end
 
       def level=(level)
+        if @level_forced
+          warn('Logger level is forced; ignoring override', id: :logger)
+          return
+        end
+
         if level == :info && @logger.level == :info
           info(':info is now the default log level, to see additional logging, set log level to :debug')
         end
@@ -71,6 +94,11 @@ module Selenium
       # @param [String] io
       #
       def output=(io)
+        if @output_forced
+          warn('Logger output is forced; ignoring override', id: :logger)
+          return
+        end
+
         @logger.reopen(io)
       end
 

data/lib/selenium/webdriver/common/service.rb

@@ -104,6 +104,12 @@ module Selenium
       def env_path
         ENV.fetch(self.class::DRIVER_PATH_ENV_KEY, nil)
       end
+
+      private
+
+      def warn_driver_log_override
+        WebDriver.logger.warn('SE_DEBUG is set; overriding user-specified driver logging settings', id: :se_debug)
+      end
     end # Service
   end # WebDriver
 end # Selenium

data/lib/selenium/webdriver/common/service_manager.rb

@@ -80,7 +80,13 @@ module Selenium
       def build_process(*command)
         WebDriver.logger.debug("Executing Process #{command}", id: :driver_service)
         @process = ChildProcess.build(*command)
-        @io ||= WebDriver.logger.io if WebDriver.logger.debug?
+        if ENV.key?('SE_DEBUG')
+          if @io && @io != WebDriver.logger.io
+            WebDriver.logger.warn('SE_DEBUG is set; overriding user-specified driver log output to use stderr',
+                                  id: :se_debug)
+          end
+          @io = WebDriver.logger.io
+        end
         @process.io = @io if @io
 
         @process

data/lib/selenium/webdriver/common.rb

@@ -78,6 +78,7 @@ require 'selenium/webdriver/common/driver_extensions/has_addons'
 require 'selenium/webdriver/common/driver_extensions/has_bidi'
 require 'selenium/webdriver/common/driver_extensions/has_devtools'
 require 'selenium/webdriver/common/driver_extensions/has_file_downloads'
+require 'selenium/webdriver/common/driver_extensions/has_session_events'
 require 'selenium/webdriver/common/driver_extensions/has_authentication'
 require 'selenium/webdriver/common/driver_extensions/has_logs'
 require 'selenium/webdriver/common/driver_extensions/has_log_events'

data/lib/selenium/webdriver/edge/service.rb

@@ -25,6 +25,17 @@ module Selenium
         EXECUTABLE = 'msedgedriver'
         SHUTDOWN_SUPPORTED = true
         DRIVER_PATH_ENV_KEY = 'SE_EDGEDRIVER'
+
+        def initialize(args: nil, **)
+          if ENV.key?('SE_DEBUG')
+            args = Array(args.dup)
+            warn_driver_log_override if args.reject! { |arg| arg.include?('log-level') || arg.include?('silent') }
+            args << '--verbose'
+          end
+
+          super
+        end
+
         def log
           return @log unless @log.is_a? String
 

data/lib/selenium/webdriver/firefox/service.rb

@@ -26,14 +26,33 @@ module Selenium
         SHUTDOWN_SUPPORTED = false
         DRIVER_PATH_ENV_KEY = 'SE_GECKODRIVER'
 
-        def initialize(path: nil, port: nil, log: nil, args: nil)
-          args ||= []
+        def initialize(args: nil, **)
+          args = Array(args.dup)
           unless args.any? { |arg| arg.include?('--connect-existing') || arg.include?('--websocket-port') }
             args << '--websocket-port'
             args << '0'
           end
+
+          if ENV.key?('SE_DEBUG')
+            remove_log_args(args)
+            args << '-v'
+          end
+
           super
         end
+
+        private
+
+        def remove_log_args(args)
+          if (index = args.index('--log'))
+            args.delete_at(index) # delete '--log'
+            args.delete_at(index) if args[index] && !args[index].start_with?('-') # delete value if present
+            warn_driver_log_override
+          elsif (index = args.index { |arg| arg.start_with?('--log=') })
+            args.delete_at(index)
+            warn_driver_log_override
+          end
+        end
       end # Service
     end # Firefox
   end # WebDriver

data/lib/selenium/webdriver/ie/service.rb

@@ -25,6 +25,16 @@ module Selenium
         EXECUTABLE = 'IEDriverServer'
         SHUTDOWN_SUPPORTED = true
         DRIVER_PATH_ENV_KEY = 'SE_IEDRIVER'
+
+        def initialize(args: nil, **)
+          if ENV.key?('SE_DEBUG')
+            args = Array(args.dup)
+            warn_driver_log_override if args.reject! { |arg| arg.include?('log-level') || arg.include?('silent') }
+            args << '--log-level=DEBUG'
+          end
+
+          super
+        end
       end # Server
     end # IE
   end # WebDriver

data/lib/selenium/webdriver/remote/driver.rb

@@ -29,6 +29,7 @@ module Selenium
         include DriverExtensions::UploadsFiles
         include DriverExtensions::HasSessionId
         include DriverExtensions::HasFileDownloads
+        include DriverExtensions::HasSessionEvents
 
         def initialize(capabilities: nil, options: nil, service: nil, url: nil, **)
           raise ArgumentError, "Can not set :service object on #{self.class}" if service

data/lib/selenium/webdriver/remote/features.rb

@@ -25,7 +25,8 @@ module Selenium
           upload_file: [:post, 'session/:session_id/se/file'],
           get_downloadable_files: [:get, 'session/:session_id/se/files'],
           download_file: [:post, 'session/:session_id/se/files'],
-          delete_downloadable_files: [:delete, 'session/:session_id/se/files']
+          delete_downloadable_files: [:delete, 'session/:session_id/se/files'],
+          fire_session_event: [:post, 'session/:session_id/se/event']
         }.freeze
 
         def add_commands(commands)
@@ -69,6 +70,30 @@ module Selenium
         def delete_downloadable_files
           execute :delete_downloadable_files
         end
+
+        #
+        # Fires a custom session event to the remote server event bus.
+        # This allows test code to trigger server-side utilities that subscribe to
+        # the event bus.
+        #
+        # @param [String] event_type The type of event (e.g., "test:failed", "log:collect")
+        # @param [Hash] payload Optional data to include with the event
+        # @return [Hash] Response data including success status, event type, and timestamp
+        #
+        # @example Fire a simple event
+        #   driver.fire_session_event("test:started")
+        #
+        # @example Fire an event with payload
+        #   driver.fire_session_event("test:failed", {
+        #     testName: "LoginTest",
+        #     error: "Element not found"
+        #   })
+        #
+        def fire_session_event(event_type, payload = nil)
+          params = {eventType: event_type}
+          params[:payload] = payload if payload
+          execute :fire_session_event, {}, params
+        end
       end
     end # Remote
   end # WebDriver

data/lib/selenium/webdriver/support/block_event_listener.rb

@@ -25,9 +25,13 @@ module Selenium
           @callback = callback
         end
 
-        def method_missing(meth, *) # rubocop:disable Style/MissingRespondToMissing
+        def method_missing(meth, *)
           @callback.call(meth, *)
         end
+
+        def respond_to_missing?(_meth, _include_private = false)
+          true
+        end
       end # BlockEventListener
     end # Support
   end # WebDriver

data/lib/selenium/webdriver/support/color.rb

@@ -72,26 +72,26 @@ module Selenium
           end
         end
 
-        def self.from_hsl(h, s, l, a) # rubocop:disable Naming/MethodParameterName
-          h = Float(h) / 360
-          s = Float(s) / 100
-          l = Float(l) / 100
-          a = Float(a || 1)
-
-          if s.zero?
-            r = l
+        def self.from_hsl(hue, sat, light, alpha)
+          hue = Float(hue) / 360
+          sat = Float(sat) / 100
+          light = Float(light) / 100
+          alpha = Float(alpha || 1)
+
+          if sat.zero?
+            r = light
             g = r
             b = r
           else
-            luminocity2 = l < 0.5 ? l * (s + 1) : l + s - (l * s)
-            luminocity1 = (l * 2) - luminocity2
+            luminocity2 = light < 0.5 ? light * (sat + 1) : light + sat - (light * sat)
+            luminocity1 = (light * 2) - luminocity2
 
-            r = hue_to_rgb(luminocity1, luminocity2, h + (1.0 / 3.0))
-            g = hue_to_rgb(luminocity1, luminocity2, h)
-            b = hue_to_rgb(luminocity1, luminocity2, h - (1.0 / 3.0))
+            r = hue_to_rgb(luminocity1, luminocity2, hue + (1.0 / 3.0))
+            g = hue_to_rgb(luminocity1, luminocity2, hue)
+            b = hue_to_rgb(luminocity1, luminocity2, hue - (1.0 / 3.0))
           end
 
-          new (r * 255).round, (g * 255).round, (b * 255).round, a
+          new (r * 255).round, (g * 255).round, (b * 255).round, alpha
         end
 
         def self.hue_to_rgb(lum1, lum2, hue)

data/lib/selenium/webdriver/support/event_firing_bridge.rb

@@ -120,9 +120,13 @@ module Selenium
           returned
         end
 
-        def method_missing(meth, ...) # rubocop:disable Style/MissingRespondToMissing
+        def method_missing(meth, ...)
           @delegate.__send__(meth, ...)
         end
+
+        def respond_to_missing?(meth, include_private = false)
+          @delegate.respond_to?(meth, include_private) || super
+        end
       end # EventFiringBridge
     end # Support
   end # WebDriver

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.40.0'
+    VERSION = '4.41.0'
   end # WebDriver
 end # Selenium

data/lib/selenium/webdriver.rb

@@ -96,7 +96,12 @@ module Selenium
 
     def self.logger(**)
       level = $DEBUG || ENV.key?('DEBUG') || ENV.key?('SE_DEBUG') ? :debug : :info
-      @logger ||= WebDriver::Logger.new('Selenium', default_level: level, **)
+      @logger ||= WebDriver::Logger.new('Selenium', default_level: level, **).tap do |logger|
+        if ENV.key?('SE_DEBUG')
+          logger.debug!
+          logger.stderr!
+        end
+      end
     end
   end # WebDriver
 end # Selenium

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.40.0
+  version: 4.41.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-18 00:00:00.000000000 Z
+date: 2026-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -333,6 +333,7 @@ files:
 - lib/selenium/webdriver/common/driver_extensions/has_network_interception.rb
 - lib/selenium/webdriver/common/driver_extensions/has_permissions.rb
 - lib/selenium/webdriver/common/driver_extensions/has_pinned_scripts.rb
+- lib/selenium/webdriver/common/driver_extensions/has_session_events.rb
 - lib/selenium/webdriver/common/driver_extensions/has_session_id.rb
 - lib/selenium/webdriver/common/driver_extensions/prints_page.rb
 - lib/selenium/webdriver/common/driver_extensions/uploads_files.rb