selenium-webdriver 4.32.0 → 4.38.0

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

@@ -68,9 +68,9 @@ module Selenium
       # @api private
       #
 
-      def initialize(bridge: nil, listener: nil, **opts)
+      def initialize(bridge: nil, listener: nil, **)
         @devtools = nil
-        bridge ||= create_bridge(**opts)
+        bridge ||= create_bridge(**)
         @bridge = listener ? Support::EventFiringBridge.new(bridge, listener) : bridge
         add_extensions(@bridge.browser)
       end
@@ -131,8 +131,8 @@ module Selenium
       # @see ActionBuilder
       #
 
-      def action(**opts)
-        bridge.action(**opts)
+      def action(**)
+        bridge.action(**)
       end
 
       #
@@ -225,8 +225,8 @@ module Selenium
       #   The value returned from the script.
       #
 
-      def execute_script(script, *args)
-        bridge.execute_script(script, *args)
+      def execute_script(script, *)
+        bridge.execute_script(script, *)
       end
 
       # Execute an asynchronous piece of JavaScript in the context of the
@@ -244,8 +244,8 @@ module Selenium
       # @return [WebDriver::Element,Integer,Float,Boolean,NilClass,String,Array]
       #
 
-      def execute_async_script(script, *args)
-        bridge.execute_async_script(script, *args)
+      def execute_async_script(script, *)
+        bridge.execute_async_script(script, *)
       end
 
       #

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

@@ -39,7 +39,13 @@ module Selenium
 
           begin
             Zip::File.open("#{file_name}.zip") do |zip|
-              zip.each { |entry| zip.extract(entry, "#{target_directory}#{file_name}") }
+              zip.each do |entry|
+                if Zipper::RUBYZIP_V3
+                  zip.extract(entry, file_name, destination_directory: target_directory)
+                else
+                  zip.extract(entry, "#{target_directory}#{file_name}")
+                end
+              end
             end
           ensure
             FileUtils.rm_f("#{file_name}.zip")

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

@@ -38,9 +38,9 @@ module Selenium
       ERROR_URL = 'https://www.selenium.dev/documentation/webdriver/troubleshooting/errors'
 
       URLS = {
-        NoSuchElementError: "#{ERROR_URL}#no-such-element-exception",
-        StaleElementReferenceError: "#{ERROR_URL}#stale-element-reference-exception",
-        InvalidSelectorError: "#{ERROR_URL}#invalid-selector-exception",
+        NoSuchElementError: "#{ERROR_URL}#nosuchelementexception",
+        StaleElementReferenceError: "#{ERROR_URL}#staleelementreferenceexception",
+        InvalidSelectorError: "#{ERROR_URL}#invalidselectorexception",
         NoSuchDriverError: "#{ERROR_URL}/driver_location"
       }.freeze
 

data/lib/selenium/webdriver/common/interactions/key_actions.rb

@@ -44,8 +44,8 @@ module Selenium
       # @return [ActionBuilder] A self reference
       #
 
-      def key_down(*args, device: nil)
-        key_action(*args, action: :create_key_down, device: device)
+      def key_down(*, device: nil)
+        key_action(*, action: :create_key_down, device: device)
       end
 
       #
@@ -71,8 +71,8 @@ module Selenium
       # @return [ActionBuilder] A self reference
       #
 
-      def key_up(*args, device: nil)
-        key_action(*args, action: :create_key_up, device: device)
+      def key_up(*, device: nil)
+        key_action(*, action: :create_key_up, device: device)
       end
 
       #

data/lib/selenium/webdriver/common/interactions/pointer_actions.rb

@@ -46,8 +46,8 @@ module Selenium
       # @return [ActionBuilder] A self reference.
       #
 
-      def pointer_down(button = :left, device: nil, **opts)
-        button_action(button, :create_pointer_down, device: device, **opts)
+      def pointer_down(button = :left, device: nil, **)
+        button_action(button, :create_pointer_down, device: device, **)
       end
 
       #
@@ -63,8 +63,8 @@ module Selenium
       # @return [ActionBuilder] A self reference.
       #
 
-      def pointer_up(button = :left, device: nil, **opts)
-        button_action(button, :create_pointer_up, device: device, **opts)
+      def pointer_up(button = :left, device: nil, **)
+        button_action(button, :create_pointer_up, device: device, **)
       end
 
       #
@@ -122,13 +122,13 @@ module Selenium
       # @raise [MoveTargetOutOfBoundsError] if the provided offset is outside the document's boundaries.
       #
 
-      def move_by(right_by, down_by, device: nil, duration: default_move_duration, **opts)
+      def move_by(right_by, down_by, device: nil, duration: default_move_duration, **)
         pointer = pointer_input(device)
         pointer.create_pointer_move(duration: duration,
                                     x: Integer(right_by),
                                     y: Integer(down_by),
                                     origin: Interactions::PointerMove::POINTER,
-                                    **opts)
+                                    **)
         tick(pointer)
         self
       end
@@ -150,13 +150,13 @@ module Selenium
       # @raise [MoveTargetOutOfBoundsError] if the provided x or y value is outside the document's boundaries.
       #
 
-      def move_to_location(x, y, device: nil, duration: default_move_duration, **opts)
+      def move_to_location(x, y, device: nil, duration: default_move_duration, **)
         pointer = pointer_input(device)
         pointer.create_pointer_move(duration: duration,
                                     x: Integer(x),
                                     y: Integer(y),
                                     origin: Interactions::PointerMove::VIEWPORT,
-                                    **opts)
+                                    **)
         tick(pointer)
         self
       end
@@ -336,9 +336,9 @@ module Selenium
 
       private
 
-      def button_action(button, action, device: nil, **opts)
+      def button_action(button, action, device: nil, **)
         pointer = pointer_input(device)
-        pointer.send(action, button, **opts)
+        pointer.send(action, button, **)
         tick(pointer)
         self
       end

data/lib/selenium/webdriver/common/interactions/pointer_input.rb

@@ -49,16 +49,16 @@ module Selenium
           KIND[pointer]
         end
 
-        def create_pointer_move(duration: 0, x: 0, y: 0, origin: nil, **opts)
-          add_action(PointerMove.new(self, duration, x, y, origin: origin, **opts))
+        def create_pointer_move(duration: 0, x: 0, y: 0, origin: nil, **)
+          add_action(PointerMove.new(self, duration, x, y, origin: origin, **))
         end
 
-        def create_pointer_down(button, **opts)
-          add_action(PointerPress.new(self, :down, button, **opts))
+        def create_pointer_down(button, **)
+          add_action(PointerPress.new(self, :down, button, **))
         end
 
-        def create_pointer_up(button, **opts)
-          add_action(PointerPress.new(self, :up, button, **opts))
+        def create_pointer_up(button, **)
+          add_action(PointerPress.new(self, :up, button, **))
         end
 
         def create_pointer_cancel

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

@@ -75,6 +75,13 @@ module Selenium
         subtract: "\ue027",
         decimal: "\ue028",
         divide: "\ue029",
+        numpad_multiply: "\ue024",
+        numpad_add: "\ue025",
+        numpad_comma: "\ue026",
+        numpad_subtract: "\ue027",
+        numpad_decimal: "\ue028",
+        numpad_divide: "\ue029",
+        numpad_enter: "\ue007",
         f1: "\ue031",
         f2: "\ue032",
         f3: "\ue033",
@@ -95,6 +102,8 @@ module Selenium
         right_control: "\ue051",
         right_alt: "\ue052",
         right_meta: "\ue053",
+        options: "\ue052",
+        function: "\ue051", # macOS Function key, same as right_control
         numpad_page_up: "\ue054",
         numpad_page_down: "\ue055",
         numpad_end: "\ue056",

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

@@ -79,6 +79,8 @@ module Selenium
       #
 
       def delete_cookie(name)
+        raise ArgumentError, 'Cookie name cannot be null or empty' if name.nil? || name.to_s.strip.empty?
+
         @bridge.delete_cookie name
       end
 

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

@@ -29,26 +29,26 @@ module Selenium
       class << self
         attr_reader :driver_path
 
-        def chrome(**opts)
-          Chrome::Options.new(**opts)
+        def chrome(**)
+          Chrome::Options.new(**)
         end
 
-        def firefox(**opts)
-          Firefox::Options.new(**opts)
+        def firefox(**)
+          Firefox::Options.new(**)
         end
 
-        def ie(**opts)
-          IE::Options.new(**opts)
+        def ie(**)
+          IE::Options.new(**)
         end
         alias internet_explorer ie
 
-        def edge(**opts)
-          Edge::Options.new(**opts)
+        def edge(**)
+          Edge::Options.new(**)
         end
         alias microsoftedge edge
 
-        def safari(**opts)
-          Safari::Options.new(**opts)
+        def safari(**)
+          Safari::Options.new(**)
         end
 
         def set_capabilities
@@ -131,11 +131,20 @@ module Selenium
 
       def process_w3c_options(options)
         w3c_options = options.select { |key, val| w3c?(key) && !val.nil? }
-        w3c_options[:unhandled_prompt_behavior] &&= w3c_options[:unhandled_prompt_behavior]&.to_s&.tr('_', ' ')
+        w3c_options[:unhandled_prompt_behavior] &&=
+          process_unhandled_prompt_behavior_value(w3c_options[:unhandled_prompt_behavior])
         options.delete_if { |key, _val| w3c?(key) }
         w3c_options
       end
 
+      def process_unhandled_prompt_behavior_value(value)
+        if value.is_a?(Hash)
+          value.transform_values { |v| process_unhandled_prompt_behavior_value(v) }
+        else
+          value&.to_s&.tr('_', ' ')
+        end
+      end
+
       def process_browser_options(_browser_options)
         nil
       end

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

@@ -51,9 +51,7 @@ module Selenium
       end
 
       def ci
-        if ENV['TRAVIS']
-          :travis
-        elsif ENV['JENKINS']
+        if ENV['JENKINS']
           :jenkins
         elsif ENV['APPVEYOR']
           :appveyor

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

@@ -77,6 +77,7 @@ module Selenium
       alias eql? ==
 
       def ftp=(value)
+        WebDriver.logger.deprecate('FTP proxy support', nil, id: :ftp_proxy)
         self.type = :manual
         @ftp = value
       end

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

@@ -28,27 +28,27 @@ module Selenium
       class << self
         attr_reader :driver_path
 
-        def chrome(**opts)
-          Chrome::Service.new(**opts)
+        def chrome(**)
+          Chrome::Service.new(**)
         end
 
-        def firefox(**opts)
-          Firefox::Service.new(**opts)
+        def firefox(**)
+          Firefox::Service.new(**)
         end
 
-        def ie(**opts)
-          IE::Service.new(**opts)
+        def ie(**)
+          IE::Service.new(**)
         end
         alias internet_explorer ie
 
-        def edge(**opts)
-          Edge::Service.new(**opts)
+        def edge(**)
+          Edge::Service.new(**)
         end
         alias microsoftedge edge
         alias msedge edge
 
-        def safari(**opts)
-          Safari::Service.new(**opts)
+        def safari(**)
+          Safari::Service.new(**)
         end
 
         def driver_path=(path)

data/lib/selenium/webdriver/common/virtual_authenticator/credential.rb

@@ -26,12 +26,12 @@ module Selenium
   module WebDriver
     class Credential
       class << self
-        def resident(**opts)
-          Credential.new(resident_credential: true, **opts)
+        def resident(**)
+          Credential.new(resident_credential: true, **)
         end
 
-        def non_resident(**opts)
-          Credential.new(resident_credential: false, **opts)
+        def non_resident(**)
+          Credential.new(resident_credential: false, **)
         end
 
         def encode(byte_array)

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

@@ -29,7 +29,7 @@ module Selenium
       # @param [Hash] opts Options for this instance
       # @option opts [Numeric] :timeout (5) Seconds to wait before timing out.
       # @option opts [Numeric] :interval (0.2) Seconds to sleep between polls.
-      # @option opts [String] :message Exception mesage if timed out.
+      # @option opts [String] :message Exception message if timed out.
       # @option opts [Array, Exception] :ignore Exceptions to ignore while polling (default: Error::NoSuchElementError)
       #
 

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

@@ -18,6 +18,7 @@
 # under the License.
 
 require 'zip'
+require 'zip/version' # Not required automatically
 require 'tempfile'
 require 'find'
 require 'base64'
@@ -30,6 +31,7 @@ module Selenium
 
     module Zipper
       EXTENSIONS = %w[.zip .xpi].freeze
+      RUBYZIP_V3 = Zip::VERSION >= '3.0.0'
 
       class << self
         def unzip(path)
@@ -42,7 +44,11 @@ module Selenium
               dirname = File.dirname(to)
 
               FileUtils.mkdir_p dirname
-              zip.extract(entry, to)
+              if RUBYZIP_V3
+                zip.extract(entry, entry.name, destination_directory: destination)
+              else
+                zip.extract(entry, to)
+              end
             end
           end
 
@@ -75,7 +81,11 @@ module Selenium
           # Don't use Tempfile since it lacks rb_file_s_rename permission on Windows.
           Dir.mktmpdir do |tmp_dir|
             zip_path = File.join(tmp_dir, 'webdriver-zip')
-            Zip::File.open(zip_path, Zip::File::CREATE, &blk)
+            if RUBYZIP_V3
+              Zip::File.open(zip_path, create: true, &blk)
+            else
+              Zip::File.open(zip_path, Zip::File::CREATE, &blk)
+            end
           end
         end
 

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

@@ -30,9 +30,9 @@ module Selenium
       class Driver < Chromium::Driver
         include LocalDriver
 
-        def initialize(options: nil, service: nil, url: nil, **opts)
+        def initialize(options: nil, service: nil, url: nil, **)
           caps, url = initialize_local_driver(options, service, url)
-          super(caps: caps, url: url, **opts)
+          super(caps: caps, url: url, **)
         end
 
         def browser

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

@@ -36,9 +36,9 @@ module Selenium
 
         include LocalDriver
 
-        def initialize(options: nil, service: nil, url: nil, **opts)
+        def initialize(options: nil, service: nil, url: nil, **)
           caps, url = initialize_local_driver(options, service, url)
-          super(caps: caps, url: url, **opts)
+          super(caps: caps, url: url, **)
         end
 
         def browser

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

@@ -28,9 +28,9 @@ module Selenium
 
         def initialize(path: nil, port: nil, log: nil, args: nil)
           args ||= []
-          unless args.any? { |arg| arg.include?('--connect-existing') }
+          unless args.any? { |arg| arg.include?('--connect-existing') || arg.include?('--websocket-port') }
             args << '--websocket-port'
-            args << WebDriver::PortProber.above(9222).to_s
+            args << '0'
           end
           super
         end

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

@@ -31,9 +31,9 @@ module Selenium
 
         include LocalDriver
 
-        def initialize(options: nil, service: nil, url: nil, **opts)
+        def initialize(options: nil, service: nil, url: nil, **)
           caps, url = initialize_local_driver(options, service, url)
-          super(caps: caps, url: url, **opts)
+          super(caps: caps, url: url, **)
         end
 
         def browser

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

@@ -30,12 +30,12 @@ module Selenium
         include DriverExtensions::HasSessionId
         include DriverExtensions::HasFileDownloads
 
-        def initialize(capabilities: nil, options: nil, service: nil, url: nil, **opts)
+        def initialize(capabilities: nil, options: nil, service: nil, url: nil, **)
           raise ArgumentError, "Can not set :service object on #{self.class}" if service
 
           url ||= "http://#{Platform.localhost}:4444/wd/hub"
           caps = process_options(options, capabilities)
-          super(caps: caps, url: url, **opts)
+          super(caps: caps, url: url, **)
           @bridge.file_detector = ->((filename, *)) { File.exist?(filename) && filename.to_s }
           command_list = @bridge.command_list
           @bridge.extend(WebDriver::Remote::Features)

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

@@ -31,9 +31,9 @@ module Selenium
 
         include LocalDriver
 
-        def initialize(options: nil, service: nil, url: nil, **opts)
+        def initialize(options: nil, service: nil, url: nil, **)
           caps, url = initialize_local_driver(options, service, url)
-          super(caps: caps, url: url, **opts)
+          super(caps: caps, url: url, **)
         end
 
         def browser

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

@@ -25,8 +25,8 @@ module Selenium
           @callback = callback
         end
 
-        def method_missing(meth, *args) # rubocop:disable Style/MissingRespondToMissing
-          @callback.call meth, *args
+        def method_missing(meth, *) # rubocop:disable Style/MissingRespondToMissing
+          @callback.call(meth, *)
         end
       end # BlockEventListener
     end # Support

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

@@ -112,10 +112,10 @@ module Selenium
           @driver ||= Driver.new(bridge: self)
         end
 
-        def dispatch(name, *args)
-          @listener.__send__(:"before_#{name}", *args)
+        def dispatch(name, *)
+          @listener.__send__(:"before_#{name}", *)
           returned = yield
-          @listener.__send__(:"after_#{name}", *args)
+          @listener.__send__(:"after_#{name}", *)
 
           returned
         end

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.32.0'
+    VERSION = '4.38.0'
   end # WebDriver
 end # Selenium

data/lib/selenium/webdriver.rb

@@ -21,7 +21,6 @@ require 'tmpdir'
 require 'fileutils'
 require 'date'
 require 'json'
-require 'set'
 require 'uri'
 require 'net/http'
 
@@ -85,8 +84,8 @@ module Selenium
     # @see Selenium::WebDriver::Support::AbstractEventListener
     #
 
-    def self.for(*args)
-      WebDriver::Driver.for(*args)
+    def self.for(*)
+      WebDriver::Driver.for(*)
     end
 
     #
@@ -95,9 +94,9 @@ module Selenium
     # @return [Logger]
     #
 
-    def self.logger(**opts)
+    def self.logger(**)
       level = $DEBUG || ENV.key?('DEBUG') ? :debug : :info
-      @logger ||= WebDriver::Logger.new('Selenium', default_level: level, **opts)
+      @logger ||= WebDriver::Logger.new('Selenium', default_level: level, **)
     end
   end # WebDriver
 end # Selenium

data/selenium-webdriver.gemspec

@@ -30,7 +30,7 @@ Gem::Specification.new do |s|
   }
 
   s.required_rubygems_version = Gem::Requirement.new('> 1.3.1') if s.respond_to? :required_rubygems_version=
-  s.required_ruby_version = Gem::Requirement.new('>= 3.1')
+  s.required_ruby_version = Gem::Requirement.new('>= 3.2')
 
   s.files = [
     'CHANGES',
@@ -52,7 +52,7 @@ Gem::Specification.new do |s|
   s.add_dependency 'base64', ['~> 0.2']
   s.add_dependency 'logger', ['~> 1.4']
   s.add_dependency 'rexml', ['~> 3.2', '>= 3.2.5']
-  s.add_dependency 'rubyzip', ['>= 1.2.2', '< 3.0']
+  s.add_dependency 'rubyzip', ['>= 1.2.2', '< 4.0']
   s.add_dependency 'websocket', ['~> 1.0']
 
   s.add_development_dependency 'git', ['~> 1.19']

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.32.0
+  version: 4.38.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-05-02 00:00:00.000000000 Z
+date: 2025-10-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -69,7 +69,7 @@ dependencies:
         version: 1.2.2
     - - "<"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -79,7 +79,7 @@ dependencies:
         version: 1.2.2
     - - "<"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
   name: websocket
   requirement: !ruby/object:Gem::Requirement
@@ -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
@@ -475,14 +470,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: Selenium is a browser automation tool for automated testing of webapps and