selenium-webdriver 4.46.0 → 4.48.0

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

@@ -37,7 +37,9 @@ module Selenium
 
           caps = process_options(options, capabilities)
           http_client ||= Remote::Http::Default.new(client_config: client_config)
-          http_client.server_url = url || client_config&.server_url || "http://#{Platform.localhost}:4444/wd/hub"
+          server_url = url || client_config&.server_url || "http://#{Platform.localhost}:4444/wd/hub"
+          http_client.server_url = server_url
+          caps['se:remoteUrl'] = server_url.to_s.chomp('/')
           super(caps: caps, http_client: http_client, **)
           @bridge.file_detector = ->((filename, *)) { File.exist?(filename) && filename.to_s }
           command_list = @bridge.command_list

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

@@ -124,7 +124,7 @@ module Selenium
           end
 
           def follow_redirect(response, redirects)
-            WebDriver.logger.debug("Redirect to #{response['Location']}; times: #{redirects}")
+            WebDriver.logger.debug("Redirect to #{response['Location']}; times: #{redirects}", id: :redirect)
             raise Error::WebDriverError, 'too many redirects' if redirects >= client_config.max_redirects
 
             request(:get, URI.parse(response['Location']), DEFAULT_HEADERS.dup, nil, redirects + 1)

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

@@ -25,7 +25,8 @@ module Selenium
 
         # @see https://developer.apple.com/documentation/webkit/about_webdriver_for_safari
         CAPABILITIES = {automatic_inspection: 'safari:automaticInspection',
-                        automatic_profiling: 'safari:automaticProfiling'}.freeze
+                        automatic_profiling: 'safari:automaticProfiling',
+                        experimental_web_socket_url: 'safari:experimentalWebSocketUrl'}.freeze
         BROWSER = 'safari'
         TECHNOLOGY_PREVIEW = 'Safari Technology Preview'
 
@@ -43,6 +44,20 @@ module Selenium
         def browser_name
           @options[:browser_name] = Safari.technology_preview? ? TECHNOLOGY_PREVIEW : BROWSER
         end
+
+        #
+        # Enables WebDriver BiDi for Safari, which also requires the experimental capability, and
+        # warns that Safari's BiDi support is experimental.
+        #
+        # @return [Boolean]
+        #
+
+        def enable_bidi!
+          super
+          WebDriver.logger.warn("Safari's WebDriver BiDi support is experimental and may be incomplete",
+                                id: :safari_bidi)
+          @options[:experimental_web_socket_url] = true
+        end
       end # Options
     end # Safari
   end # WebDriver

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

@@ -30,7 +30,7 @@ module Selenium
           attr_reader :guarded, :type, :messages, :reason, :tracker
 
           def initialize(guarded, type, guards = nil)
-            @guarded = guarded
+            @guarded = guarded.dup
             @tracker = guards&.bug_tracker || ''
             @messages = guards&.messages || {}
             @messages[:unknown] = 'TODO: Investigate why this is failing and file a bug report'
@@ -47,7 +47,7 @@ module Selenium
                       when Symbol
                         messages[reason]
                       else
-                        "Guarded by #{guarded};"
+                        "#{type.to_s.tr('_', ' ')} #{guarded};"
                       end
 
             case type
@@ -57,8 +57,10 @@ module Selenium
               "Test skipped because it is unreliable in this configuration; #{details}"
             when :skip_unless, :exclusive
               "Test does not apply to this configuration; #{details}"
-            else
+            when :pending_if, :pending_unless, :except, :only
               "Test guarded; #{details}"
+            else
+              raise ArgumentError, "unknown guard type: #{type}"
             end
           end
 
@@ -81,6 +83,21 @@ module Selenium
           def exclusive?
             @type == :skip_unless || @type == :exclusive
           end
+
+          # A pending guard that only applies when the failure matches an expected exception.
+          def exception?
+            (except? || only?) && !@guarded[:exception].nil?
+          end
+
+          # Whether the exception is the guard's `exception:` class and matches its optional `message:`
+          # (Regexp pattern or exact String), following RSpec's `raise_error` semantics.
+          def matches_exception?(exception)
+            spec = @guarded[:exception]
+            return false unless spec && exception.is_a?(spec[:class])
+
+            message = spec[:message]
+            message.nil? || (message.is_a?(Regexp) ? message.match?(exception.message) : message == exception.message)
+          end
         end # Guard
       end # Guards
     end # Support

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

@@ -41,7 +41,7 @@ module Selenium
         def add_condition(name, condition = false, &block)
           condition = false if condition.nil?
           @guard_conditions << GuardCondition.new(name, condition, &block)
-          WebDriver.logger.debug "Running with Guard '#{name}' set to: #{condition}"
+          WebDriver.logger.debug "Running with Guard '#{name}' set to: #{condition}", id: :guard
         end
 
         def add_message(name, message)
@@ -52,12 +52,18 @@ module Selenium
           if !skipping_guard.nil?
             [:skip, skipping_guard.message]
           elsif !pending_guard.nil? && ENV.fetch('SKIP_PENDING', nil)
-            [:skip, pending_guard.message]
-          elsif !pending_guard.nil?
+            [:skip, "(skipped by SKIP_PENDING) #{pending_guard.message}"]
+          elsif !pending_guard.nil? && !pending_guard.exception?
             [:pending, pending_guard.message]
           end
         end
 
+        # The deferred `exception:` pending guard, evaluated against the failure after the run, else nil.
+        def pending_exception_guard
+          guard = pending_guard
+          guard if disposition.nil? && guard&.exception?
+        end
+
         def satisfied?(guard)
           @guard_conditions.all? { |condition| condition.satisfied?(guard) }
         end

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.46.0'
+    VERSION = '4.48.0'
   end # WebDriver
 end # Selenium

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.46.0
+  version: 4.48.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -10,7 +10,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-07-11 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -273,6 +273,8 @@ files:
 - README.md
 - bin/linux/selenium-manager
 - bin/macos/selenium-manager
+- bin/selenium-manager-THIRD-PARTY-NOTICES.txt
+- bin/selenium-manager.cdx.json
 - bin/windows/selenium-manager.exe
 - lib/selenium-webdriver.rb
 - lib/selenium/server.rb
@@ -285,6 +287,7 @@ files:
 - lib/selenium/webdriver/bidi.rb
 - lib/selenium/webdriver/bidi/browser.rb
 - lib/selenium/webdriver/bidi/browsing_context.rb
+- lib/selenium/webdriver/bidi/error.rb
 - lib/selenium/webdriver/bidi/log_handler.rb
 - lib/selenium/webdriver/bidi/network.rb
 - lib/selenium/webdriver/bidi/network/cookies.rb
@@ -301,6 +304,7 @@ files:
 - lib/selenium/webdriver/bidi/protocol/browsing_context.rb
 - lib/selenium/webdriver/bidi/protocol/domain.rb
 - lib/selenium/webdriver/bidi/protocol/emulation.rb
+- lib/selenium/webdriver/bidi/protocol/error_code.rb
 - lib/selenium/webdriver/bidi/protocol/input.rb
 - lib/selenium/webdriver/bidi/protocol/log.rb
 - lib/selenium/webdriver/bidi/protocol/network.rb
@@ -341,7 +345,6 @@ files:
 - lib/selenium/webdriver/common/driver_extensions/has_addons.rb
 - lib/selenium/webdriver/common/driver_extensions/has_apple_permissions.rb
 - lib/selenium/webdriver/common/driver_extensions/has_authentication.rb
-- lib/selenium/webdriver/common/driver_extensions/has_bidi.rb
 - lib/selenium/webdriver/common/driver_extensions/has_casting.rb
 - lib/selenium/webdriver/common/driver_extensions/has_cdp.rb
 - lib/selenium/webdriver/common/driver_extensions/has_context.rb

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

@@ -1,36 +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 DriverExtensions
-      module HasBiDi
-        #
-        # Retrieves WebDriver BiDi connection.
-        #
-        # @return [BiDi]
-        #
-
-        def bidi
-          @bridge.bidi
-        end
-      end # HasBiDi
-    end # DriverExtensions
-  end # WebDriver
-end # Selenium