selenium-webdriver 4.35.0 → 4.41.0

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/remote/http/common.rb

@@ -28,6 +28,7 @@ module Selenium
             'Accept' => CONTENT_TYPE,
             'Content-Type' => "#{CONTENT_TYPE}; charset=UTF-8"
           }.freeze
+          BINARY_ENCODINGS = [Encoding::BINARY, Encoding::ASCII_8BIT].freeze
 
           class << self
             attr_accessor :extra_headers
@@ -55,6 +56,7 @@ module Selenium
             headers['Cache-Control'] = 'no-cache' if verb == :get
 
             if command_hash
+              command_hash              = ensure_utf8_encoding(command_hash)
               payload                   = JSON.generate(command_hash)
               headers['Content-Length'] = payload.bytesize.to_s if %i[post put].include?(verb)
 
@@ -91,6 +93,36 @@ module Selenium
             raise NotImplementedError, 'subclass responsibility'
           end
 
+          def ensure_utf8_encoding(obj)
+            case obj
+            when String
+              encode_string_to_utf8(obj)
+            when Array
+              obj.map { |item| ensure_utf8_encoding(item) }
+            when Hash
+              obj.each_with_object({}) do |(key, value), result|
+                result[ensure_utf8_encoding(key)] = ensure_utf8_encoding(value)
+              end
+            else
+              obj
+            end
+          end
+
+          def encode_string_to_utf8(str)
+            return str if str.encoding == Encoding::UTF_8 && str.valid_encoding?
+
+            if BINARY_ENCODINGS.include?(str.encoding)
+              result = str.dup.force_encoding(Encoding::UTF_8)
+              return result if result.valid_encoding?
+            end
+
+            str.encode(Encoding::UTF_8)
+          rescue EncodingError => e
+            raise Error::WebDriverError,
+                  "Unable to encode string to UTF-8: #{e.message}. " \
+                  "String encoding: #{str.encoding}, content: #{str.inspect}"
+          end
+
           def create_response(code, body, content_type)
             code = code.to_i
             body = body.to_s.strip

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

@@ -32,8 +32,9 @@ module Selenium
         include LocalDriver
 
         def initialize(options: nil, service: nil, url: nil, **)
-          caps, url = initialize_local_driver(options, service, url)
-          super(caps: caps, url: url, **)
+          initialize_local_driver(options, service, url) do |caps, driver_url|
+            super(caps: caps, url: driver_url, **)
+          end
         end
 
         def browser

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.35.0'
+    VERSION = '4.41.0'
   end # WebDriver
 end # Selenium

data/lib/selenium/webdriver.rb

@@ -95,8 +95,13 @@ module Selenium
     #
 
     def self.logger(**)
-      level = $DEBUG || ENV.key?('DEBUG') ? :debug : :info
-      @logger ||= WebDriver::Logger.new('Selenium', default_level: level, **)
+      level = $DEBUG || ENV.key?('DEBUG') || ENV.key?('SE_DEBUG') ? :debug : :info
+      @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.35.0
+  version: 4.41.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-08-12 00:00:00.000000000 Z
+date: 2026-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -283,14 +283,9 @@ files:
 - lib/selenium/webdriver/atoms/isDisplayed.js
 - lib/selenium/webdriver/atoms/mutationListener.js
 - lib/selenium/webdriver/bidi.rb
+- lib/selenium/webdriver/bidi/browser.rb
 - lib/selenium/webdriver/bidi/browsing_context.rb
-- lib/selenium/webdriver/bidi/log/base_log_entry.rb
-- lib/selenium/webdriver/bidi/log/console_log_entry.rb
-- lib/selenium/webdriver/bidi/log/filter_by.rb
-- lib/selenium/webdriver/bidi/log/generic_log_entry.rb
-- lib/selenium/webdriver/bidi/log/javascript_log_entry.rb
 - lib/selenium/webdriver/bidi/log_handler.rb
-- lib/selenium/webdriver/bidi/log_inspector.rb
 - lib/selenium/webdriver/bidi/network.rb
 - lib/selenium/webdriver/bidi/network/cookies.rb
 - lib/selenium/webdriver/bidi/network/credentials.rb
@@ -338,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

data/lib/selenium/webdriver/bidi/log/base_log_entry.rb

@@ -1,35 +0,0 @@
-# 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
-    class BiDi
-      class BaseLogEntry
-        attr_accessor :level, :text, :timestamp, :stack_trace
-
-        def initialize(level:, text:, timestamp:, stack_trace:)
-          @level = level
-          @text = text
-          @timestamp = timestamp
-          @stack_trace = stack_trace
-        end
-      end # BaseLogEntry
-    end # BiDi
-  end # WebDriver
-end # Selenium

data/lib/selenium/webdriver/bidi/log/console_log_entry.rb

@@ -1,35 +0,0 @@
-# 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
-    class BiDi
-      class ConsoleLogEntry < GenericLogEntry
-        attr_accessor :method, :realm, :args
-
-        def initialize(method:, realm:, args:, **)
-          super(**)
-          @method = method
-          @realm = realm
-          @args = args
-        end
-      end # ConsoleLogEntry
-    end # BiDi
-  end # WebDriver
-end # Selenium

data/lib/selenium/webdriver/bidi/log/filter_by.rb

@@ -1,40 +0,0 @@
-# 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
-    class BiDi
-      class FilterBy
-        attr_accessor :level
-
-        def initialize(level)
-          @level = level
-        end
-
-        def self.log_level(level = nil)
-          unless %w[debug error info warning].include?(level)
-            raise Error::WebDriverError,
-                  "Valid log levels are 'debug', 'error', 'info' and 'warning'. Received: #{level}"
-          end
-          FilterBy.new(level)
-        end
-      end # FilterBy
-    end # BiDi
-  end # WebDriver
-end # Selenium

data/lib/selenium/webdriver/bidi/log/generic_log_entry.rb

@@ -1,33 +0,0 @@
-# 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
-    class BiDi
-      class GenericLogEntry < BaseLogEntry
-        attr_accessor :type
-
-        def initialize(level:, text:, timestamp:, type:, stack_trace:)
-          super(level: level, text: text, timestamp: timestamp, stack_trace: stack_trace)
-          @type = type
-        end
-      end # GenericLogEntry
-    end # BiDi
-  end # WebDriver
-end # Selenium

data/lib/selenium/webdriver/bidi/log/javascript_log_entry.rb

@@ -1,33 +0,0 @@
-# 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
-    class BiDi
-      class JavascriptLogEntry < GenericLogEntry
-        attr_accessor :type
-
-        def initialize(level:, text:, timestamp:, type:, stack_trace:)
-          super
-          @type = 'javascript'
-        end
-      end # JavascriptLogEntry
-    end # BiDi
-  end # WebDriver
-end # Selenium

data/lib/selenium/webdriver/bidi/log_inspector.rb

@@ -1,147 +0,0 @@
-# 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.
-
-# This file is automatically generated. Any changes will be lost!
-
-require_relative 'log/base_log_entry'
-require_relative 'log/generic_log_entry'
-require_relative 'log/console_log_entry'
-require_relative 'log/javascript_log_entry'
-require_relative 'log/filter_by'
-
-module Selenium
-  module WebDriver
-    class BiDi
-      class LogInspector
-        EVENTS = {
-          entry_added: 'entryAdded'
-        }.freeze
-
-        LOG_LEVEL = {
-          DEBUG: 'debug',
-          ERROR: 'error',
-          INFO: 'info',
-          WARNING: 'warning'
-        }.freeze
-
-        def initialize(driver, browsing_context_ids = nil)
-          WebDriver.logger.deprecate('LogInspector class',
-                                     'Script class with driver.script',
-                                     id: :log_inspector)
-
-          unless driver.capabilities.web_socket_url
-            raise Error::WebDriverError,
-                  'WebDriver instance must support BiDi protocol'
-          end
-
-          @bidi = driver.bidi
-          @bidi.session.subscribe('log.entryAdded', browsing_context_ids)
-        end
-
-        def on_console_entry(filter_by = nil, &block)
-          check_valid_filter(filter_by)
-
-          on_log do |params|
-            type = params['type']
-            console_log_events(params, filter_by, &block) if type.eql?('console')
-          end
-        end
-
-        def on_javascript_log(filter_by = nil, &block)
-          check_valid_filter(filter_by)
-
-          on_log do |params|
-            type = params['type']
-            javascript_log_events(params, filter_by, &block) if type.eql?('javascript')
-          end
-        end
-
-        def on_javascript_exception(&block)
-          on_log do |params|
-            type = params['type']
-            javascript_log_events(params, FilterBy.log_level('error'), &block) if type.eql?('javascript')
-          end
-        end
-
-        def on_log(filter_by = nil, &block)
-          unless filter_by.nil?
-            check_valid_filter(filter_by)
-
-            on(:entry_added) do |params|
-              yield(params) if params['level'] == filter_by.level
-            end
-            return
-          end
-
-          on(:entry_added, &block)
-        end
-
-        private
-
-        def on(event, &block)
-          event = EVENTS[event] if event.is_a?(Symbol)
-          @bidi.add_callback("log.#{event}", &block)
-        end
-
-        def check_valid_filter(filter_by)
-          return if filter_by.nil? || filter_by.instance_of?(FilterBy)
-
-          raise "Pass valid FilterBy object. Received: #{filter_by.inspect}"
-        end
-
-        def console_log_events(params, filter_by)
-          event = ConsoleLogEntry.new(
-            level: params['level'],
-            text: params['text'],
-            timestamp: params['timestamp'],
-            type: params['type'],
-            method: params['method'],
-            realm: params['realm'],
-            args: params['args'],
-            stack_trace: params['stackTrace']
-          )
-
-          unless filter_by.nil?
-            yield(event) if params['level'] == filter_by.level
-            return
-          end
-
-          yield(event)
-        end
-
-        def javascript_log_events(params, filter_by)
-          event = JavascriptLogEntry.new(
-            level: params['level'],
-            text: params['text'],
-            timestamp: params['timestamp'],
-            type: params['type'],
-            stack_trace: params['stackTrace']
-          )
-
-          unless filter_by.nil?
-            yield(event) if params['level'] == filter_by.level
-            return
-          end
-
-          yield(event)
-        end
-      end # LogInspector
-    end # Bidi
-  end # WebDriver
-end # Selenium