selenium-webdriver 4.25.0 → 4.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 933e4204f7292ea54294b360eb588ee5ce965af527555629de203f11f6535931
-  data.tar.gz: fb8f77b1b744c4e3f7922e66d9e956e41f4eba67181f0aa306ae8362730c1159
+  metadata.gz: 7809938337140c717243484ade299cbeef583af69e195bcaeef9b86b67ba2e40
+  data.tar.gz: 34eb5b08f76eb6c7b6966356ede4976e3eb392d9e03005b813bd65a7d1457647
 SHA512:
-  metadata.gz: 1c4ca19d4a8dca6fb0dc25e4ebae8aea5e3d7dd5797977b53048b5a460e1d08c65b11e335789e43d93ff64d2ac2a31c077a2631cf01041874bb0e82845509c4a
-  data.tar.gz: 1b3074dac91a3a612c64573218fb4accdc708dce7b78c31bfd8162575616da9c1cf9434463d45ef8d007fda7d28eee1d99d416f506a2c47e445f850e7a85a46d
+  metadata.gz: dc64c00f126d71a6cbc586123293bbae2d5f9d9c7af6b3aa2a6b001f0209be9f38fd6ef206ae9bdc069730c90f134bac91533600f4f7167c1ff93dd4a6ef35c6
+  data.tar.gz: 7dd948fd4f869958fe296ee7b0b1c7e593654e5b393707f7e50278ec978f0b9a566a16a3b860692add8bc751b02d2e38e2c758b4cdbabb8c97cca0ee21d1ec2e

data/CHANGES

@@ -1,3 +1,21 @@
+4.27.0 (2024-11-21)
+=========================
+* Add CDP for Chrome 131 and remove 128
+* Add Firefox CDP deprecation warnings (#14763)
+* Add Bidi network commands for authentication and interception (#14523)
+* Handle graceful webdriver shutdown (#14430)
+* Reduce RBS errors to 0 (#14661)
+* Resolve `uri` gem deprecation warning (#14770)
+* Update minimum Ruby to 3.1 (#14685)
+* Implement navigation commands with BiDi (#14094)
+
+4.26.0 (2024-10-28)
+=========================
+* Add CDP for Chrome 130 and remove 127
+* Add missing RBS methods (#14621)
+* Update Ruby BiDi script structs to match spec
+* Add RBS type support for BiDi related classes (#14611)
+
 4.25.0 (2024-09-19)
 =========================
 * Add CDP for Chrome 129 and remove 126

data/Gemfile

@@ -7,4 +7,4 @@ end
 
 gem 'curb', '~> 1.0.5', require: false, platforms: %i[mri mingw x64_mingw]
 gem 'debug', '~> 1.7', require: false, platforms: %i[mri mingw x64_mingw]
-gem 'steep', '~> 1.5.0', require: false, platforms: %i[mri mingw x64_mingw]
+gem 'steep', '1.5.2', require: false, platforms: %i[mri mingw x64_mingw]

data/README.md

@@ -1,6 +1,6 @@
 # selenium-webdriver
 
-This gem provides Ruby bindings for Selenium and supports MRI >= 3.0.
+This gem provides Ruby bindings for Selenium and supports MRI >= 3.1.
 
 ## Install
 

data/lib/selenium/server.rb

@@ -122,15 +122,15 @@ module Selenium
         end
       end
 
-      def net_http_start(address, &block)
+      def net_http_start(address, &)
         http_proxy = ENV.fetch('http_proxy', nil) || ENV.fetch('HTTP_PROXY', nil)
         if http_proxy
           http_proxy = "http://#{http_proxy}" unless http_proxy.start_with?('http://')
           uri = URI.parse(http_proxy)
 
-          Net::HTTP.start(address, nil, uri.host, uri.port, &block)
+          Net::HTTP.start(address, nil, uri.host, uri.port, &)
         else
-          Net::HTTP.start(address, use_ssl: true, &block)
+          Net::HTTP.start(address, use_ssl: true, &)
         end
       end
 

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

@@ -17,72 +17,84 @@
 # specific language governing permissions and limitations
 # under the License.
 
-require_relative 'navigate_result'
-require_relative 'browsing_context_info'
-
 module Selenium
   module WebDriver
     class BiDi
+      # Implements the browsingContext Module of the WebDriver-BiDi specification
+      #
+      # @api private
+      #
       class BrowsingContext
-        attr_accessor :id
-
         READINESS_STATE = {
-          none: 'none',
-          interactive: 'interactive',
-          complete: 'complete'
+          'none' => 'none',
+          'eager' => 'interactive',
+          'normal' => 'complete'
         }.freeze
 
-        def initialize(driver:, browsing_context_id: nil, type: nil, reference_context: nil)
-          unless driver.capabilities.web_socket_url
-            raise Error::WebDriverError,
-                  'WebDriver instance must support BiDi protocol'
-          end
-
-          unless type.nil? || %i[window tab].include?(type)
-            raise ArgumentError,
-                  "Valid types are :window & :tab. Received: #{type.inspect}"
-          end
-
-          @bidi = driver.bidi
-          @id = browsing_context_id.nil? ? create(type, reference_context)['context'] : browsing_context_id
+        # TODO: store current window handle in bridge object instead of always calling it
+        def initialize(bridge)
+          @bridge = bridge
+          @bidi = @bridge.bidi
+          page_load_strategy = bridge.capabilities[:page_load_strategy]
+          @readiness = READINESS_STATE[page_load_strategy]
         end
 
-        def navigate(url:, readiness_state: nil)
-          unless readiness_state.nil? || READINESS_STATE.key?(readiness_state)
-            raise ArgumentError,
-                  "Valid readiness states are :none, :interactive & :complete. Received: #{readiness_state.inspect}"
-          end
-
-          navigate_result = @bidi.send_cmd('browsingContext.navigate', context: @id, url: url,
-                                                                       wait: READINESS_STATE[readiness_state])
-
-          NavigateResult.new(
-            url: navigate_result['url'],
-            navigation_id: navigate_result['navigation']
-          )
+        # Navigates to the specified URL in the given browsing context.
+        #
+        # @param url [String] The URL to navigate to.
+        # @param context_id [String, NilClass] The ID of the browsing context to navigate in.
+        #   Defaults to the window handle of the current context.
+        def navigate(url, context_id: nil)
+          context_id ||= @bridge.window_handle
+          @bidi.send_cmd('browsingContext.navigate', context: context_id, url: url, wait: @readiness)
         end
 
-        def get_tree(max_depth: nil)
-          result = @bidi.send_cmd('browsingContext.getTree', root: @id, maxDepth: max_depth).dig('contexts', 0)
-
-          BrowsingContextInfo.new(
-            id: result['context'],
-            url: result['url'],
-            children: result['children'],
-            parent_context: result['parent']
-          )
+        # Traverses the browsing context history by a given delta.
+        #
+        # @param delta [Integer] The number of steps to traverse.
+        #   Positive values go forwards, negative values go backwards.
+        # @param context_id [String, NilClass] The ID of the context to traverse.
+        #   Defaults to the window handle of the current context.
+        def traverse_history(delta, context_id: nil)
+          context_id ||= @bridge.window_handle
+          @bidi.send_cmd('browsingContext.traverseHistory', context: context_id, delta: delta)
         end
 
-        def close
-          @bidi.send_cmd('browsingContext.close', context: @id)
+        # Reloads the browsing context.
+        # @param [String, NilClass] context_id The ID of the context to reload.
+        #   Defaults to the window handle of the current context.
+        # @param [Boolean] ignore_cache Whether to bypass the cache when reloading.
+        #   Defaults to false.
+        def reload(context_id: nil, ignore_cache: false)
+          context_id ||= @bridge.window_handle
+          params = {context: context_id, ignore_cache: ignore_cache, wait: @readiness}
+          @bidi.send_cmd('browsingContext.reload', **params)
         end
 
-        private
+        # Closes the browsing context.
+        #
+        # @param [String] context_id The ID of the context to close.
+        #   Defaults to the window handle of the current context.
+        def close(context_id: nil)
+          context_id ||= @bridge.window_handle
+          @bidi.send_cmd('browsingContext.close', context: context_id)
+        end
 
-        def create(type, reference_context)
-          @bidi.send_cmd('browsingContext.create', type: type.to_s, referenceContext: reference_context)
+        # Create a new browsing context.
+        #
+        # @param [Symbol] type The type of browsing context to create.
+        #   Valid options are :tab and :window with :window being the default
+        # @param [String] context_id The reference context for the new browsing context.
+        #   Defaults to the current window handle.
+        #
+        # @return [String] The context ID of the created browsing context.
+        def create(type: nil, context_id: nil)
+          type ||= :window
+          context_id ||= @bridge.window_handle
+          result = @bidi.send_cmd('browsingContext.create', type: type.to_s, referenceContext: context_id)
+          result['context']
         end
-      end # BrowsingContext
+      end
     end # BiDi
   end # WebDriver
 end # Selenium

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

@@ -21,8 +21,8 @@ module Selenium
   module WebDriver
     class BiDi
       class LogHandler
-        ConsoleLogEntry = BiDi::Struct.new(:level, :text, :timestamp, :method, :args, :type)
-        JavaScriptLogEntry = BiDi::Struct.new(:level, :text, :timestamp, :stack_trace, :type)
+        ConsoleLogEntry = BiDi::Struct.new(:level, :text, :timestamp, :stack_trace, :type, :source, :method, :args)
+        JavaScriptLogEntry = BiDi::Struct.new(:level, :text, :timestamp, :stack_trace, :type, :source)
 
         def initialize(bidi)
           @bidi = bidi
@@ -30,6 +30,7 @@ module Selenium
         end
 
         # @return [int] id of the handler
+        # steep:ignore:start
         def add_message_handler(type)
           subscribe_log_entry unless @log_entry_subscribed
           @bidi.add_callback('log.entryAdded') do |params|
@@ -39,6 +40,7 @@ module Selenium
             end
           end
         end
+        # steep:ignore:end
 
         # @param [int] id of the handler previously added
         def remove_message_handler(id)

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

@@ -79,7 +79,7 @@ module Selenium
           end
         end
 
-        def on_log(filter_by = nil, &block)
+        def on_log(filter_by = nil, &)
           unless filter_by.nil?
             check_valid_filter(filter_by)
 
@@ -89,14 +89,14 @@ module Selenium
             return
           end
 
-          on(:entry_added, &block)
+          on(:entry_added, &)
         end
 
         private
 
-        def on(event, &block)
+        def on(event, &)
           event = EVENTS[event] if event.is_a?(Symbol)
-          @bidi.add_callback("log.#{event}", &block)
+          @bidi.add_callback("log.#{event}", &)
         end
 
         def check_valid_filter(filter_by)

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

@@ -0,0 +1,70 @@
+# 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 Network
+        EVENTS = {
+          before_request: 'network.beforeRequestSent',
+          response_started: 'network.responseStarted',
+          response_completed: 'network.responseCompleted',
+          auth_required: 'network.authRequired',
+          FETCH_ERROR: 'network.fetchError'
+        }.freeze
+
+        PHASES = {
+          before_request: 'beforeRequestSent',
+          response_started: 'responseStarted',
+          auth_required: 'authRequired'
+        }.freeze
+
+        def initialize(bidi)
+          @bidi = bidi
+        end
+
+        def add_intercept(phases: [], contexts: nil, url_patterns: nil)
+          @bidi.send_cmd('network.addIntercept', phases: phases, contexts: contexts, urlPatterns: url_patterns)
+        end
+
+        def remove_intercept(intercept)
+          @bidi.send_cmd('network.removeIntercept', intercept: intercept)
+        end
+
+        def continue_with_auth(request_id, username, password)
+          @bidi.send_cmd(
+            'network.continueWithAuth',
+            'request' => request_id,
+            'action' => 'provideCredentials',
+            'credentials' => {
+              'type' => 'password',
+              'username' => username,
+              'password' => password
+            }
+          )
+        end
+
+        def on(event, &)
+          event = EVENTS[event] if event.is_a?(Symbol)
+          @bidi.add_callback(event, &)
+        end
+      end # Network
+    end # BiDi
+  end # WebDriver
+end # Selenium

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

@@ -37,8 +37,6 @@ module Selenium
           end
         end
       end
-    end
-
-    # BiDi
+    end # BiDi
   end # WebDriver
 end # Selenium

data/lib/selenium/webdriver/bidi.rb

@@ -25,6 +25,7 @@ module Selenium
       autoload :LogHandler, 'selenium/webdriver/bidi/log_handler'
       autoload :BrowsingContext, 'selenium/webdriver/bidi/browsing_context'
       autoload :Struct, 'selenium/webdriver/bidi/struct'
+      autoload :Network, 'selenium/webdriver/bidi/network'
 
       def initialize(url:)
         @ws = WebSocketConnection.new(url: url)
@@ -38,8 +39,8 @@ module Selenium
         @ws.callbacks
       end
 
-      def add_callback(event, &block)
-        @ws.add_callback(event, &block)
+      def add_callback(event, &)
+        @ws.add_callback(event, &)
       end
 
       def remove_callback(event, id)

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

@@ -64,16 +64,10 @@ module Selenium
         return unless @pid
         return if exited?
 
-        WebDriver.logger.debug("Sending TERM to process: #{@pid}", id: :process)
-        terminate(@pid)
-        poll_for_exit(timeout)
-
-        WebDriver.logger.debug("  -> stopped #{@pid}", id: :process)
-      rescue TimeoutError, Errno::EINVAL
-        WebDriver.logger.debug("    -> sending KILL to process: #{@pid}", id: :process)
-        kill(@pid)
-        wait
-        WebDriver.logger.debug("      -> killed #{@pid}", id: :process)
+        terminate_and_wait_else_kill(timeout)
+      rescue Errno::ECHILD, Errno::ESRCH => e
+        # Process exited earlier than terminate/kill could catch
+        WebDriver.logger.debug("    -> process: #{@pid} does not exist (#{e.class.name})", id: :process)
       end
 
       def alive?
@@ -91,6 +85,9 @@ module Selenium
         WebDriver.logger.debug("  -> exit code is #{exit_code.inspect}", id: :process)
 
         !!exit_code
+      rescue Errno::ECHILD, Errno::ESRCH
+        WebDriver.logger.debug("  -> process: #{@pid} already finished", id: :process)
+        true
       end
 
       def poll_for_exit(timeout)
@@ -110,20 +107,29 @@ module Selenium
 
       private
 
+      def terminate_and_wait_else_kill(timeout)
+        WebDriver.logger.debug("Sending TERM to process: #{@pid}", id: :process)
+        terminate(@pid)
+        poll_for_exit(timeout)
+
+        WebDriver.logger.debug("  -> stopped #{@pid}", id: :process)
+      rescue TimeoutError, Errno::EINVAL
+        WebDriver.logger.debug("    -> sending KILL to process: #{@pid}", id: :process)
+        kill(@pid)
+        wait
+        WebDriver.logger.debug("      -> killed #{@pid}", id: :process)
+      end
+
       def terminate(pid)
         Process.kill(SIGTERM, pid)
       end
 
       def kill(pid)
         Process.kill(SIGKILL, pid)
-      rescue Errno::ECHILD, Errno::ESRCH
-        # already dead
       end
 
       def waitpid2(pid, flags = 0)
         Process.waitpid2(pid, flags)
-      rescue Errno::ECHILD
-        # already dead
       end
     end # ChildProcess
   end # WebDriver

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

@@ -264,6 +264,15 @@ module Selenium
         bridge.add_virtual_authenticator(options)
       end
 
+      #
+      # @return [Network]
+      # @see Network
+      #
+
+      def network
+        @network ||= WebDriver::Network.new(bridge)
+      end
+
       #-------------------------------- sugar  --------------------------------
 
       #

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

@@ -57,6 +57,13 @@ module Selenium
         #
 
         def on_log_event(kind, &block)
+          if browser == :firefox
+            WebDriver.logger.deprecate(
+              'Driver#on_log_event on Firefox',
+              'the script.add_console_message_handler or the script.add_javascript_error_handler methods',
+              id: :on_log_event
+            )
+          end
           raise Error::WebDriverError, "Don't know how to handle #{kind} events" unless KINDS.include?(kind)
 
           enabled = log_listeners[kind].any?

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

@@ -59,9 +59,16 @@ module Selenium
         # @yieldparam [Proc] continue block which proceeds with the request and optionally yields response
         #
 
-        def intercept(&block)
+        def intercept(&)
+          if browser == :firefox
+            WebDriver.logger.deprecate(
+              'Driver#intercept on Firefox',
+              'the new bidi.network.add_intercept method',
+              id: :intercept
+            )
+          end
           @interceptor ||= DevTools::NetworkInterceptor.new(devtools)
-          @interceptor.intercept(&block)
+          @interceptor.intercept(&)
         end
       end # HasNetworkInterception
     end # DriverExtensions

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

@@ -50,9 +50,11 @@ module Selenium
           super(URLS[class_name] ? "#{msg}; #{SUPPORT_MSG} #{URLS[class_name]}" : msg)
         end
 
+        # steep:ignore:start
         def class_name
-          self.class.name&.split('::')&.last&.to_sym
+          self.class.name.split('::')&.last&.to_sym
         end
+        # steep:ignore:end
       end
 
       #

data/lib/selenium/webdriver/common/fedcm/account.rb

@@ -30,9 +30,7 @@ module Selenium
         attr_reader :account_id, :email, :name, :given_name, :picture_url,
                     :idp_config_url, :login_state, :terms_of_service_url, :privacy_policy_url
 
-        # Initializes a new account with the provided attributes.
-        #
-        # @param [Hash]
+        # steep:ignore:start
         def initialize(**args)
           @account_id = args['accountId']
           @email = args['email']
@@ -44,6 +42,7 @@ module Selenium
           @terms_of_service_url = args['termsOfServiceUrl']
           @privacy_policy_url = args['privacyPolicyUrl']
         end
+        # steep:ignore:end
       end # Account
     end # FedCM
   end # WebDriver

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

@@ -193,7 +193,7 @@ module Selenium
 
       def discard_or_log(level, message, id)
         id = Array(id)
-        return if (@ignored & id).any?
+        return if @ignored.intersect?(id)
         return if @allowed.any? && (@allowed & id).none?
 
         return if ::Logger::Severity.const_get(level.upcase) < @logger.level

data/lib/selenium/webdriver/{bidi/browsing_context_info.rb → common/network.rb}

@@ -19,17 +19,34 @@
 
 module Selenium
   module WebDriver
-    class BiDi
-      class BrowsingContextInfo
-        attr_accessor :id, :url, :children, :parent_browsing_context
+    class Network
+      attr_reader :auth_callbacks
 
-        def initialize(id:, url:, children:, parent_context:)
-          @id = id
-          @url = url
-          @children = children
-          @parent_browsing_context = parent_context
+      def initialize(bridge)
+        @network = BiDi::Network.new(bridge.bidi)
+        @auth_callbacks = {}
+      end
+
+      def add_authentication_handler(username, password)
+        intercept = @network.add_intercept(phases: [BiDi::Network::PHASES[:auth_required]])
+        auth_id = @network.on(:auth_required) do |event|
+          request_id = event['requestId']
+          @network.continue_with_auth(request_id, username, password)
         end
-      end # BrowsingContextInfo
-    end # BiDi
+        @auth_callbacks[auth_id] = intercept
+
+        auth_id
+      end
+
+      def remove_authentication_handler(id)
+        intercept = @auth_callbacks[id]
+        @network.remove_intercept(intercept['intercept'])
+        @auth_callbacks.delete(id)
+      end
+
+      def clear_authentication_handlers
+        @auth_callbacks.each_key { |id| remove_authentication_handler(id) }
+      end
+    end # Network
   end # WebDriver
 end # Selenium

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

@@ -25,13 +25,13 @@ module Selenium
       end
 
       # @return [int] id of the handler
-      def add_console_message_handler(&block)
-        @log_handler.add_message_handler('console', &block)
+      def add_console_message_handler(&)
+        @log_handler.add_message_handler('console', &)
       end
 
       # @return [int] id of the handler
-      def add_javascript_error_handler(&block)
-        @log_handler.add_message_handler('javascript', &block)
+      def add_javascript_error_handler(&)
+        @log_handler.add_message_handler('javascript', &)
       end
 
       # @param [int] id of the handler previously added

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

@@ -113,6 +113,7 @@ module Selenium
       def stop_server
         connect_to_server do |http|
           headers = WebDriver::Remote::Http::Common::DEFAULT_HEADERS.dup
+          WebDriver.logger.debug('Sending shutdown request to server', id: :driver_service)
           http.get('/shutdown', headers)
         end
       end

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

@@ -50,6 +50,7 @@ module Selenium
       # @param type either :tab or :window
       #
 
+      # steep:ignore:start
       def new_window(type = :window)
         raise ArgumentError, "Valid types are :tab and :window, received: #{type.inspect}" unless %i[window
                                                                                                      tab].include?(type)
@@ -70,6 +71,7 @@ module Selenium
           window(handle)
         end
       end
+      # steep:ignore:end
 
       #
       # switch to the given window handle

data/lib/selenium/webdriver/common.rb

@@ -102,3 +102,4 @@ require 'selenium/webdriver/common/child_process'
 require 'selenium/webdriver/common/script'
 require 'selenium/webdriver/common/fedcm/account'
 require 'selenium/webdriver/common/fedcm/dialog'
+require 'selenium/webdriver/common/network'

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

@@ -29,6 +29,22 @@ module Selenium
           @bidi = Selenium::WebDriver::BiDi.new(url: socket_url)
         end
 
+        def get(url)
+          browsing_context.navigate(url)
+        end
+
+        def go_back
+          browsing_context.traverse_history(-1)
+        end
+
+        def go_forward
+          browsing_context.traverse_history(1)
+        end
+
+        def refresh
+          browsing_context.reload
+        end
+
         def quit
           super
         ensure
@@ -38,6 +54,12 @@ module Selenium
         def close
           execute(:close_window).tap { |handles| bidi.close if handles.empty? }
         end
+
+        private
+
+        def browsing_context
+          @browsing_context ||= WebDriver::BiDi::BrowsingContext.new(self)
+        end
       end # BiDiBridge
     end # Remote
   end # WebDriver

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

@@ -35,10 +35,10 @@ module Selenium
           attr_reader :extra_commands
           attr_writer :element_class, :locator_converter
 
-          def add_command(name, verb, url, &block)
+          def add_command(name, verb, url, &)
             @extra_commands ||= {}
             @extra_commands[name] = [verb, url]
-            define_method(name, &block)
+            define_method(name, &)
           end
 
           def locator_converter
@@ -686,7 +686,7 @@ module Selenium
         end
 
         def escaper
-          @escaper ||= defined?(URI::Parser) ? URI::DEFAULT_PARSER : URI
+          @escaper ||= defined?(URI::RFC2396_PARSER) ? URI::RFC2396_PARSER : URI::DEFAULT_PARSER
         end
 
         def commands(command)

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

@@ -48,6 +48,7 @@ module Selenium
             # hook for subclasses - will be called on Driver#quit
           end
 
+          # steep:ignore:start
           def call(verb, url, command_hash)
             url      = server_url.merge(url) unless url.is_a?(URI)
             headers  = common_headers.dup
@@ -66,6 +67,7 @@ module Selenium
 
             request verb, url, headers, payload
           end
+          # steep:ignore:end
 
           private
 

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

@@ -37,8 +37,8 @@ module Selenium
           @messages = {}
         end
 
-        def add_condition(name, condition = nil, &blk)
-          @guard_conditions << GuardCondition.new(name, condition, &blk)
+        def add_condition(name, condition = nil, &)
+          @guard_conditions << GuardCondition.new(name, condition, &)
         end
 
         def add_message(name, message)

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.25.0'
+    VERSION = '4.27.0'
   end # WebDriver
 end # Selenium

data/selenium-webdriver.gemspec

@@ -24,11 +24,12 @@ Gem::Specification.new do |s|
     'changelog_uri' => 'https://github.com/SeleniumHQ/selenium/blob/trunk/rb/CHANGES',
     'github_repo' => 'ssh://github.com/SeleniumHQ/selenium',
     'source_code_uri' => 'https://github.com/SeleniumHQ/selenium/tree/trunk/rb',
-    'rubygems_mfa_required' => 'true'
+    'rubygems_mfa_required' => 'true',
+    'funding_uri' => 'https://github.com/sponsors/SeleniumHQ'
   }
 
   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.0')
+  s.required_ruby_version = Gem::Requirement.new('>= 3.1')
 
   s.files = [
     'CHANGES',

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.25.0
+  version: 4.27.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-20 00:00:00.000000000 Z
+date: 2024-11-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -290,7 +290,6 @@ files:
 - lib/selenium/webdriver/atoms/mutationListener.js
 - lib/selenium/webdriver/bidi.rb
 - lib/selenium/webdriver/bidi/browsing_context.rb
-- lib/selenium/webdriver/bidi/browsing_context_info.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
@@ -298,7 +297,7 @@ files:
 - 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/navigate_result.rb
+- lib/selenium/webdriver/bidi/network.rb
 - lib/selenium/webdriver/bidi/session.rb
 - lib/selenium/webdriver/bidi/struct.rb
 - lib/selenium/webdriver/chrome.rb
@@ -376,6 +375,7 @@ files:
 - lib/selenium/webdriver/common/logs.rb
 - lib/selenium/webdriver/common/manager.rb
 - lib/selenium/webdriver/common/navigation.rb
+- lib/selenium/webdriver/common/network.rb
 - lib/selenium/webdriver/common/options.rb
 - lib/selenium/webdriver/common/platform.rb
 - lib/selenium/webdriver/common/port_prober.rb
@@ -466,6 +466,7 @@ metadata:
   github_repo: ssh://github.com/SeleniumHQ/selenium
   source_code_uri: https://github.com/SeleniumHQ/selenium/tree/trunk/rb
   rubygems_mfa_required: 'true'
+  funding_uri: https://github.com/sponsors/SeleniumHQ
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -474,14 +475,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">"
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.3.27
 signing_key:
 specification_version: 4
 summary: Selenium is a browser automation tool for automated testing of webapps and

data/lib/selenium/webdriver/bidi/navigate_result.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 NavigateResult
-        attr_accessor :url, :navigation_id
-
-        def initialize(url:, navigation_id:)
-          @url = url
-          @navigation_id = navigation_id
-        end
-      end # NavigateResult
-    end # BiDi
-  end # WebDriver
-end # Selenium