selenium-webdriver 4.23.0 → 4.31.0

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

@@ -30,10 +30,8 @@ module Selenium
                       DriverExtensions::FullPageScreenshot,
                       DriverExtensions::HasContext,
                       DriverExtensions::HasBiDi,
-                      DriverExtensions::HasDevTools,
                       DriverExtensions::HasLogEvents,
                       DriverExtensions::HasNetworkInterception,
-                      DriverExtensions::HasWebStorage,
                       DriverExtensions::PrintsPage].freeze
 
         include LocalDriver
@@ -46,23 +44,6 @@ module Selenium
         def browser
           :firefox
         end
-
-        private
-
-        def devtools_url
-          if capabilities['moz:debuggerAddress'].nil?
-            raise(Error::WebDriverError, 'DevTools is not supported by this version of Firefox; use v85 or higher')
-          end
-
-          uri = URI("http://#{capabilities['moz:debuggerAddress']}")
-          response = Net::HTTP.get(uri.hostname, '/json/version', uri.port)
-
-          JSON.parse(response)['webSocketDebuggerUrl']
-        end
-
-        def devtools_version
-          Firefox::DEVTOOLS_VERSION
-        end
       end # Driver
     end # Firefox
   end # WebDriver

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

@@ -24,6 +24,7 @@ module Selenium
         DEFAULT_PORT = 4444
         EXECUTABLE = 'geckodriver'
         SHUTDOWN_SUPPORTED = false
+        DRIVER_PATH_ENV_KEY = 'SE_GECKODRIVER'
       end # Service
     end # Firefox
   end # WebDriver

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

@@ -27,7 +27,7 @@ module Selenium
       #
 
       class Driver < WebDriver::Driver
-        EXTENSIONS = [DriverExtensions::HasWebStorage].freeze
+        EXTENSIONS = [].freeze
 
         include LocalDriver
 

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

@@ -24,6 +24,7 @@ module Selenium
         DEFAULT_PORT = 5555
         EXECUTABLE = 'IEDriverServer'
         SHUTDOWN_SUPPORTED = true
+        DRIVER_PATH_ENV_KEY = 'SE_IEDRIVER'
       end # Server
     end # IE
   end # WebDriver

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

@@ -296,58 +296,6 @@ module Selenium
           execute :take_element_screenshot, id: element
         end
 
-        #
-        # HTML 5
-        #
-
-        def local_storage_item(key, value = nil)
-          if value
-            execute_script("localStorage.setItem('#{key}', '#{value}')")
-          else
-            execute_script("return localStorage.getItem('#{key}')")
-          end
-        end
-
-        def remove_local_storage_item(key)
-          execute_script("localStorage.removeItem('#{key}')")
-        end
-
-        def local_storage_keys
-          execute_script('return Object.keys(localStorage)')
-        end
-
-        def clear_local_storage
-          execute_script('localStorage.clear()')
-        end
-
-        def local_storage_size
-          execute_script('return localStorage.length')
-        end
-
-        def session_storage_item(key, value = nil)
-          if value
-            execute_script("sessionStorage.setItem('#{key}', '#{value}')")
-          else
-            execute_script("return sessionStorage.getItem('#{key}')")
-          end
-        end
-
-        def remove_session_storage_item(key)
-          execute_script("sessionStorage.removeItem('#{key}')")
-        end
-
-        def session_storage_keys
-          execute_script('return Object.keys(sessionStorage)')
-        end
-
-        def clear_session_storage
-          execute_script('sessionStorage.clear()')
-        end
-
-        def session_storage_size
-          execute_script('return sessionStorage.length')
-        end
-
         #
         # javascript execution
         #
@@ -375,6 +323,8 @@ module Selenium
         end
 
         def delete_cookie(name)
+          raise ArgumentError, 'Cookie name cannot be null or empty' if name.nil? || name.to_s.strip.empty?
+
           execute :delete_cookie, name: name
         end
 
@@ -676,7 +626,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/remote/http/curb.rb

@@ -37,6 +37,13 @@ module Selenium
         #
 
         class Curb < Common
+          attr_accessor :timeout
+
+          def initialize(timeout: nil)
+            @timeout = timeout
+            super()
+          end
+
           def quit_errors
             [Curl::Err::RecvError] + super
           end
@@ -53,7 +60,7 @@ module Selenium
             client.headers = headers
 
             # http://github.com/taf2/curb/issues/issue/33
-            client.head   = false
+            client.head = false
             client.delete = false
 
             case verb
@@ -80,11 +87,10 @@ module Selenium
             @client ||= begin
               c = Curl::Easy.new
 
-              c.max_redirects   = MAX_REDIRECTS
+              c.max_redirects = MAX_REDIRECTS
               c.follow_location = true
-              c.timeout         = @timeout if @timeout
-              c.verbose         = WebDriver.logger.debug?
-
+              c.timeout = timeout if timeout
+              c.verbose = WebDriver.logger.debug?
               c
             end
           end

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

@@ -58,12 +58,30 @@ module Selenium
 
         def add_cause(ex, error, backtrace)
           cause = Error::WebDriverError.new
+          backtrace = backtrace_from_remote(backtrace) if backtrace.is_a?(Array)
           cause.set_backtrace(backtrace)
           raise ex, cause: cause
         rescue Error.for_error(error)
           ex
         end
 
+        def backtrace_from_remote(server_trace)
+          server_trace.filter_map do |frame|
+            next unless frame.is_a?(Hash)
+
+            file = frame['fileName']
+            line = frame['lineNumber']
+            method = frame['methodName']
+
+            class_name = frame['className']
+            file = "#{class_name}(#{file})" if class_name
+
+            method = 'unknown' if method.nil? || method.empty?
+
+            "[remote server] #{file}:#{line}:in `#{method}'"
+          end
+        end
+
         def process_error
           return unless self['value'].is_a?(Hash)
 

data/lib/selenium/webdriver/remote.rb

@@ -31,7 +31,7 @@ module Selenium
       autoload :Capabilities, 'selenium/webdriver/remote/capabilities'
 
       module Http
-        autoload :Common,  'selenium/webdriver/remote/http/common'
+        autoload :Common, 'selenium/webdriver/remote/http/common'
         autoload :Default, 'selenium/webdriver/remote/http/default'
       end
     end

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

@@ -27,8 +27,7 @@ module Selenium
 
       class Driver < WebDriver::Driver
         EXTENSIONS = [DriverExtensions::HasDebugger,
-                      DriverExtensions::HasApplePermissions,
-                      DriverExtensions::HasWebStorage].freeze
+                      DriverExtensions::HasApplePermissions].freeze
 
         include LocalDriver
 

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

@@ -24,7 +24,7 @@ module Selenium
         DEFAULT_PORT = 7050
         EXECUTABLE = 'safaridriver'
         SHUTDOWN_SUPPORTED = false
-
+        DRIVER_PATH_ENV_KEY = 'SE_SAFARIDRIVER'
         def initialize(path: nil, port: nil, log: nil, args: nil)
           raise Error::WebDriverError, 'Safari Service does not support setting log output' if log
 

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, &block)
+          @guard_conditions << GuardCondition.new(name, condition, &block)
         end
 
         def add_message(name, message)

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.23.0'
+    VERSION = '4.31.0'
   end # WebDriver
 end # Selenium

data/selenium-webdriver.gemspec

@@ -22,13 +22,15 @@ Gem::Specification.new do |s|
   s.homepage = 'https://selenium.dev'
   s.metadata = {
     'changelog_uri' => 'https://github.com/SeleniumHQ/selenium/blob/trunk/rb/CHANGES',
+    'documentation_uri' => 'https://www.selenium.dev/documentation/?tab=ruby',
     '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.23.0
+  version: 4.31.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-07-18 00:00:00.000000000 Z
+date: 2025-04-05 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,15 @@ 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/network/cookies.rb
+- lib/selenium/webdriver/bidi/network/credentials.rb
+- lib/selenium/webdriver/bidi/network/headers.rb
+- lib/selenium/webdriver/bidi/network/intercepted_auth.rb
+- lib/selenium/webdriver/bidi/network/intercepted_item.rb
+- lib/selenium/webdriver/bidi/network/intercepted_request.rb
+- lib/selenium/webdriver/bidi/network/intercepted_response.rb
+- lib/selenium/webdriver/bidi/network/url_pattern.rb
 - lib/selenium/webdriver/bidi/session.rb
 - lib/selenium/webdriver/bidi/struct.rb
 - lib/selenium/webdriver/chrome.rb
@@ -338,7 +345,6 @@ files:
 - 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_id.rb
-- lib/selenium/webdriver/common/driver_extensions/has_web_storage.rb
 - lib/selenium/webdriver/common/driver_extensions/prints_page.rb
 - lib/selenium/webdriver/common/driver_extensions/uploads_files.rb
 - lib/selenium/webdriver/common/driver_finder.rb
@@ -348,9 +354,6 @@ files:
 - lib/selenium/webdriver/common/fedcm/account.rb
 - lib/selenium/webdriver/common/fedcm/dialog.rb
 - lib/selenium/webdriver/common/file_reaper.rb
-- lib/selenium/webdriver/common/html5/local_storage.rb
-- lib/selenium/webdriver/common/html5/session_storage.rb
-- lib/selenium/webdriver/common/html5/shared_web_storage.rb
 - lib/selenium/webdriver/common/interactions/input_device.rb
 - lib/selenium/webdriver/common/interactions/interaction.rb
 - lib/selenium/webdriver/common/interactions/interactions.rb
@@ -376,6 +379,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
@@ -463,9 +467,11 @@ licenses:
 - Apache-2.0
 metadata:
   changelog_uri: https://github.com/SeleniumHQ/selenium/blob/trunk/rb/CHANGES
+  documentation_uri: https://www.selenium.dev/documentation/?tab=ruby
   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 +480,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/common/html5/local_storage.rb

@@ -1,59 +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
-    module HTML5
-      class LocalStorage
-        include SharedWebStorage
-
-        #
-        # @api private
-        #
-        def initialize(bridge)
-          @bridge = bridge
-        end
-
-        def [](key)
-          @bridge.local_storage_item key
-        end
-
-        def []=(key, value)
-          @bridge.local_storage_item key, value
-        end
-
-        def delete(key)
-          @bridge.remove_local_storage_item key
-        end
-
-        def clear
-          @bridge.clear_local_storage
-        end
-
-        def size
-          @bridge.local_storage_size
-        end
-
-        def keys
-          @bridge.local_storage_keys.reverse
-        end
-      end # LocalStorage
-    end # HTML5
-  end # WebDriver
-end # Selenium