selenium-webdriver 4.44.0 → 4.45.0

data/lib/selenium/webdriver/chromium/profile.rb

@@ -28,6 +28,12 @@ module Selenium
         include ProfileHelper
 
         def initialize(model = nil)
+          WebDriver.logger.deprecate(
+            'Chromium::Profile (including Chrome::Profile and Edge::Profile)',
+            "Options#add_argument('--user-data-dir=...'), Options#add_preference, and Options#add_extension",
+            id: :chromium_profile
+          )
+
           @model = verify_model(model)
           @extensions = []
           @encoded_extensions = []

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

@@ -26,6 +26,8 @@ module Selenium
         new(options, service_class.new).driver_path
       end
 
+      # @param options [Options, nil] when nil driver parsed from Service::EXECUTABLE
+      # @param service [Service]
       def initialize(options, service)
         @options = options
         @service = service
@@ -47,36 +49,43 @@ module Selenium
 
       def paths
         @paths ||= begin
-          path = @service.class.driver_path
-          path = path.call if path.is_a?(Proc)
-          exe = @service.class::EXECUTABLE
-          if path
-            WebDriver.logger.debug("Skipping Selenium Manager; path to #{exe} specified in service class: #{path}")
-            Platform.assert_executable(path)
-            {driver_path: path}
-          else
-            output = SeleniumManager.binary_paths(*to_args)
-            formatted = {driver_path: Platform.cygwin_path(output['driver_path'], only_cygwin: true),
-                         browser_path: Platform.cygwin_path(output['browser_path'], only_cygwin: true)}
-            Platform.assert_executable(formatted[:driver_path])
-
-            browser_path = formatted[:browser_path]
-            Platform.assert_executable(browser_path)
-            if @options.respond_to?(:binary) && @options.binary.nil?
-              @options.binary = browser_path
-              @options.browser_version = nil
-            end
-
-            formatted
-          end
+          path = @service.executable_path || env_path || class_path
+          path ? paths_from_service(path) : paths_from_manager
         rescue StandardError => e
           WebDriver.logger.error("Exception occurred: #{e.message}")
           WebDriver.logger.error("Backtrace:\n\t#{e.backtrace&.join("\n\t")}")
-          raise Error::NoSuchDriverError, "Unable to obtain #{exe}"
+          raise Error::NoSuchDriverError, "Unable to obtain #{@service.class::EXECUTABLE}"
         end
       end
 
+      def env_path
+        ENV.fetch(@service.class::DRIVER_PATH_ENV_KEY, nil)
+      end
+
+      def class_path
+        path = @service.class.driver_path
+        path.is_a?(Proc) ? path.call : path
+      end
+
+      def paths_from_service(path)
+        exe = @service.class::EXECUTABLE
+        WebDriver.logger.debug("Skipping Selenium Manager; path to #{exe} specified in service class: #{path}")
+        Platform.assert_executable(path)
+        {driver_path: path}
+      end
+
+      def paths_from_manager
+        output = SeleniumManager.binary_paths(*to_args)
+        formatted = {driver_path: Platform.cygwin_path(output['driver_path'], only_cygwin: true),
+                     browser_path: Platform.cygwin_path(output['browser_path'], only_cygwin: true)}
+        Platform.assert_executable(formatted[:driver_path])
+        Platform.assert_executable(formatted[:browser_path])
+        formatted
+      end
+
       def to_args
+        return ['--driver', @service.class::EXECUTABLE] unless @options
+
         args = ['--browser', @options.browser_name]
         if @options.browser_version
           args << '--browser-version'

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

@@ -48,14 +48,10 @@ module Selenium
           raise ArgumentError, ":options must be an instance of #{default_options.class}"
         end
 
-        service.executable_path ||= begin
-          finder = WebDriver::DriverFinder.new(options, service)
-          if options.respond_to?(:binary) && finder.browser_path?
-            options.binary = finder.browser_path
-            options.browser_version = nil
-          end
-          finder.driver_path
-        end
+        finder = WebDriver::DriverFinder.new(options, service)
+        options.binary = finder.browser_path if options.respond_to?(:binary) && finder.browser_path?
+        service.executable_path = finder.driver_path
+        options.browser_version = nil if options.respond_to?(:binary) && options.binary
         options.as_json
       end
     end

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

@@ -69,7 +69,6 @@ module Selenium
       def initialize(path: nil, port: nil, log: nil, args: nil)
         port ||= self.class::DEFAULT_PORT
         args ||= []
-        path ||= env_path
 
         @executable_path = path
         @host = Platform.localhost
@@ -88,7 +87,7 @@ module Selenium
       end
 
       def launch
-        @executable_path ||= env_path || find_driver_path
+        @executable_path ||= DriverFinder.new(nil, self).driver_path
         ServiceManager.new(self).tap(&:start)
       end
 
@@ -96,15 +95,6 @@ module Selenium
         self.class::SHUTDOWN_SUPPORTED
       end
 
-      def find_driver_path
-        default_options = WebDriver.const_get("#{self.class.name&.split('::')&.[](2)}::Options").new
-        DriverFinder.new(default_options, self).driver_path
-      end
-
-      def env_path
-        ENV.fetch(self.class::DRIVER_PATH_ENV_KEY, nil)
-      end
-
       private
 
       def warn_driver_log_override

data/lib/selenium/webdriver/remote/http/curb.rb

@@ -26,20 +26,18 @@ module Selenium
         #
         # An alternative to the default Net::HTTP client.
         #
-        # This can be used for the Firefox and Remote drivers if you have Curb
-        # installed.
-        #
-        # @example Using Curb
-        #   require 'selenium/webdriver/remote/http/curb'
-        #   include Selenium
-        #
-        #   driver = WebDriver.for :firefox, :http_client => WebDriver::Remote::Http::Curb.new
+        # @deprecated Subclass {Selenium::WebDriver::Remote::Http::Common} to implement a custom HTTP client.
         #
 
         class Curb < Common
           attr_accessor :timeout
 
           def initialize(timeout: nil)
+            WebDriver.logger.deprecate(
+              'Selenium::WebDriver::Remote::Http::Curb',
+              'a custom subclass of Selenium::WebDriver::Remote::Http::Common',
+              id: :curb
+            )
             @timeout = timeout
             super()
           end

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

@@ -26,7 +26,8 @@ module Selenium
         # @see https://developer.apple.com/documentation/webkit/about_webdriver_for_safari
         CAPABILITIES = {automatic_inspection: 'safari:automaticInspection',
                         automatic_profiling: 'safari:automaticProfiling'}.freeze
-        BROWSER = Selenium::WebDriver::Safari.technology_preview? ? 'Safari Technology Preview' : 'safari'
+        BROWSER = 'safari'
+        TECHNOLOGY_PREVIEW = 'Safari Technology Preview'
 
         def add_option(name, value = nil)
           key = name.is_a?(Hash) ? name.keys.first : name
@@ -35,9 +36,12 @@ module Selenium
           super
         end
 
-        def as_json(*)
-          @options[:browser_name] = Safari.technology_preview? ? 'Safari Technology Preview' : 'safari'
-          super
+        def browser_name=(value)
+          @options[:browser_name] = value
+        end
+
+        def browser_name
+          @options[:browser_name] = Safari.technology_preview? ? TECHNOLOGY_PREVIEW : BROWSER
         end
       end # Options
     end # Safari

data/lib/selenium/webdriver/safari.rb

@@ -33,7 +33,6 @@ module Selenium
         end
 
         def technology_preview!
-          Service.driver_path = technology_preview
           @use_technology_preview = true
         end
 
@@ -47,11 +46,7 @@ module Selenium
         end
 
         def path
-          @path ||= '/Applications/Safari.app/Contents/MacOS/Safari'
-          return @path if File.file?(@path) && File.executable?(@path)
-          raise Error::WebDriverError, 'Safari is only supported on Mac' unless Platform.os.mac?
-
-          raise Error::WebDriverError, 'Unable to find Safari'
+          @path ||= nil
         end
       end
     end # Safari

data/lib/selenium/webdriver/support/guards/guard.rb

@@ -51,36 +51,35 @@ module Selenium
                       end
 
             case type
-            when :exclude
+            when :skip_if, :exclude
               "Test skipped because it breaks test run; #{details}"
             when :flaky
               "Test skipped because it is unreliable in this configuration; #{details}"
-            when :exclusive
+            when :skip_unless, :exclusive
               "Test does not apply to this configuration; #{details}"
             else
               "Test guarded; #{details}"
             end
           end
 
-          # Bug is present on all configurations specified
+          # Test is expected to fail on the configurations specified (marked pending).
           def except?
-            @type == :except
+            @type == :pending_if || @type == :except
           end
 
-          # Bug is present on all configurations not specified
+          # Test is expected to fail on every configuration except those specified (marked pending).
           def only?
-            @type == :only
+            @type == :pending_unless || @type == :only
           end
 
-          # Bug is present on all configurations specified, but test can not be run because it breaks other tests,
-          # or it is flaky and unreliable
+          # Test is skipped on the configurations specified because it breaks the run or is unreliable.
           def exclude?
-            @type == :exclude || @type == :flaky
+            @type == :skip_if || @type == :exclude || @type == :flaky
           end
 
-          # Test only applies to configurations specified
+          # Test is skipped on every configuration except those specified (it only applies there).
           def exclusive?
-            @type == :exclusive
+            @type == :skip_unless || @type == :exclusive
           end
         end # Guard
       end # Guards

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

@@ -24,7 +24,8 @@ module Selenium
   module WebDriver
     module Support
       class Guards
-        GUARD_TYPES = %i[except only exclude exclusive flaky].freeze
+        GUARD_TYPES = %i[pending_if pending_unless skip_if skip_unless flaky
+                         except only exclude exclusive].freeze
 
         attr_reader :messages
         attr_accessor :bug_tracker

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.44.0'
+    VERSION = '4.45.0'
   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.2')
+  s.required_ruby_version = Gem::Requirement.new('>= 3.3')
 
   s.files = [
     'CHANGES',

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.44.0
+  version: 4.45.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-12 00:00:00.000000000 Z
+date: 2026-06-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -471,14 +471,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.4.19
+rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
 summary: Selenium is a browser automation tool for automated testing of webapps and