selenium-webdriver 4.49.0 → 4.50.0

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

@@ -0,0 +1,42 @@
+# 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
+    #
+    # A browser extension installed via Driver#install_web_extension.
+    # Wraps the identifier the browser assigned; pass it to Driver#uninstall_web_extension.
+    #
+    class WebExtension
+      #
+      # @return [String] identifier assigned to the extension by the browser
+      #
+
+      attr_reader :id
+
+      #
+      # @api private
+      #
+
+      def initialize(id)
+        @id = id
+      end
+    end # WebExtension
+  end # WebDriver
+end # Selenium

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

@@ -105,7 +105,7 @@ module Selenium
 
         id = next_id
         data = payload.merge(id: id)
-        WebDriver.logger.debug "WebSocket -> #{data}"[...MAX_LOG_MESSAGE_SIZE], id: :ws
+        WebDriver.logger.debug('WebSocket ->', id: :ws) { data.to_s[...MAX_LOG_MESSAGE_SIZE] }
         data = JSON.generate(data)
         out_frame = WebSocket::Frame::Outgoing::Client.new(version: ws.version, data: data, type: 'text')
 
@@ -200,7 +200,7 @@ module Selenium
         msg = JSON.parse(message)
         @messages_mtx.synchronize { messages[msg['id']] = msg if msg.key?('id') }
 
-        WebDriver.logger.debug "WebSocket <- #{msg}"[...MAX_LOG_MESSAGE_SIZE], id: :ws
+        WebDriver.logger.debug('WebSocket <-', id: :ws) { msg.to_s[...MAX_LOG_MESSAGE_SIZE] }
         msg
       end
 

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

@@ -56,27 +56,31 @@ module Selenium
         end
 
         def zip(path)
-          with_tmp_zip do |zip|
-            ::Find.find(path) do |file|
-              add_zip_entry zip, file, file.sub("#{path}/", '') unless File.directory?(file)
-            end
+          encode_zip(path, path)
+        end
 
-            zip.commit
-            File.open(zip.name, 'rb') { |io| Base64.strict_encode64 io.read }
-          end
+        # Keeps +path+ (a file or directory) as the archive's single top-level entry, unlike #zip
+        # which flattens a directory's contents; the Grid upload endpoint returns that one entry's path.
+        def zip_root(path)
+          encode_zip(path, File.dirname(path))
         end
 
-        def zip_file(path)
+        # Backwards-compatible name for the file-only behavior #zip_root now subsumes.
+        alias zip_file zip_root
+
+        private
+
+        def encode_zip(path, base)
           with_tmp_zip do |zip|
-            add_zip_entry zip, path, File.basename(path)
+            ::Find.find(path) do |file|
+              add_zip_entry zip, file, file.sub("#{base}/", '') unless File.directory?(file)
+            end
 
             zip.commit
             File.open(zip.name, 'rb') { |io| Base64.strict_encode64 io.read }
           end
         end
 
-        private
-
         def with_tmp_zip(&blk)
           # Don't use Tempfile since it lacks rb_file_s_rename permission on Windows.
           Dir.mktmpdir do |tmp_dir|

data/lib/selenium/webdriver/common.rb

@@ -94,6 +94,7 @@ require 'selenium/webdriver/common/options'
 require 'selenium/webdriver/common/takes_screenshot'
 require 'selenium/webdriver/common/driver'
 require 'selenium/webdriver/common/element'
+require 'selenium/webdriver/common/web_extension'
 require 'selenium/webdriver/common/shadow_root'
 require 'selenium/webdriver/common/websocket_connection'
 require 'selenium/webdriver/common/child_process'

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

@@ -38,13 +38,7 @@ module Selenium
         end
 
         def install_addon(path, temporary)
-          addon = if File.directory?(path)
-                    Zipper.zip(path)
-                  else
-                    File.open(path, 'rb') { |crx_file| Base64.strict_encode64 crx_file.read }
-                  end
-
-          payload = {addon: addon}
+          payload = {addon: encode_extension(path)}
           payload[:temporary] = temporary unless temporary.nil?
           execute :install_addon, {}, payload
         end
@@ -53,6 +47,23 @@ module Selenium
           execute :uninstall_addon, {}, {id: id}
         end
 
+        def install_web_extension(path, allow_private_browsing: nil, permanent: nil)
+          unless bidi?
+            temporary = !permanent unless permanent.nil?
+            options = {temporary: temporary, allowPrivateBrowsing: allow_private_browsing}.compact
+            return WebDriver::WebExtension.new(execute(:install_addon, {}, {addon: encode_extension(path), **options}))
+          end
+
+          options = {allow_private_browsing:, permanent:}.compact
+          result = web_extension.moz.install(extension_data: web_extension_data(path), **options)
+          WebDriver::WebExtension.new(result.extension)
+        end
+
+        def uninstall_web_extension(extension_id)
+          bidi? ? web_extension.uninstall(extension: extension_id) : uninstall_addon(extension_id)
+          nil
+        end
+
         def full_screenshot
           execute :full_page_screenshot
         end

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

@@ -25,7 +25,6 @@ module Selenium
 
         VALID_PREFERENCE_TYPES = [TrueClass, FalseClass, Integer, Float, String].freeze
         WEBDRIVER_PREFS = {
-          port: 'webdriver_firefox_port',
           log_file: 'webdriver.log.file'
         }.freeze
 
@@ -74,14 +73,12 @@ module Selenium
           @model = verify_model(model)
 
           @additional_prefs = read_model_prefs
-          @extensions = {}
         end
 
         def layout_on_disk
           profile_dir = @model ? create_tmp_copy(@model) : Dir.mktmpdir('webdriver-profile')
           FileReaper << profile_dir
 
-          install_extensions(profile_dir)
           delete_lock_files(profile_dir)
           delete_extensions_cache(profile_dir)
           update_user_prefs_in(profile_dir)
@@ -108,32 +105,11 @@ module Selenium
           @additional_prefs[key.to_s] = value
         end
 
-        def port=(port)
-          WebDriver.logger.deprecate('Firefox::Profile#port=', 'the Service class', id: :firefox_profile)
-          self[WEBDRIVER_PREFS[:port]] = port
-        end
-
-        def secure_ssl=(value)
-          WebDriver.logger.deprecate('Firefox::Profile#secure_ssl=', id: :firefox_profile)
-          @secure_ssl = value
-        end
-
-        def load_no_focus_lib=(value)
-          WebDriver.logger.deprecate('Firefox::Profile#load_no_focus_lib=', id: :firefox_profile)
-          @load_no_focus_lib = value
-        end
-
         def log_file=(file)
           @log_file = file
           self[WEBDRIVER_PREFS[:log_file]] = file
         end
 
-        def add_extension(path, name = extension_name_for(path))
-          WebDriver.logger.deprecate('Firefox::Profile#add_extension', 'Driver#install_addon',
-                                     id: :firefox_profile)
-          @extensions[name] = Extension.new(path)
-        end
-
         def proxy=(proxy)
           raise TypeError, "expected #{Proxy.name}, got #{proxy.inspect}:#{proxy.class}" unless proxy.is_a? Proxy
 
@@ -169,15 +145,6 @@ module Selenium
           self["network.proxy.#{key}_port"] = Integer(port) if port
         end
 
-        def install_extensions(directory)
-          destination = File.join(directory, 'extensions')
-
-          @extensions.each do |name, extension|
-            WebDriver.logger.debug({extension: name}.inspect, id: :firefox_profile)
-            extension.write_to(destination)
-          end
-        end
-
         def read_model_prefs
           return {} unless @model
 
@@ -194,10 +161,6 @@ module Selenium
           end
         end
 
-        def extension_name_for(path)
-          File.basename(path, File.extname(path))
-        end
-
         def update_user_prefs_in(directory)
           path = File.join(directory, 'user.js')
           prefs = read_user_prefs(path)

data/lib/selenium/webdriver/firefox.rb

@@ -19,13 +19,11 @@
 
 require 'timeout'
 require 'socket'
-require 'rexml/document'
 
 module Selenium
   module WebDriver
     module Firefox
       autoload :Util, 'selenium/webdriver/firefox/util'
-      autoload :Extension, 'selenium/webdriver/firefox/extension'
       autoload :ProfilesIni, 'selenium/webdriver/firefox/profiles_ini'
       autoload :Profile, 'selenium/webdriver/firefox/profile'
       autoload :Features, 'selenium/webdriver/firefox/features'

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

@@ -45,6 +45,16 @@ module Selenium
           end
         end
 
+        def install_web_extension(path)
+          result = web_extension.install(extension_data: web_extension_data(path))
+          WebExtension.new(result.extension)
+        end
+
+        def uninstall_web_extension(id)
+          web_extension.uninstall(extension: id)
+          nil
+        end
+
         def get(url)
           browsing_context.navigate(context: window_handle, url: url, wait: readiness_state)
           nil
@@ -91,6 +101,19 @@ module Selenium
           @browsing_context ||= BiDi::Protocol::BrowsingContext.new(connection)
         end
 
+        def web_extension
+          @web_extension ||= BiDi::Protocol::WebExtension.new(connection)
+        end
+
+        # A directory only resolves on the machine running the browser, so upload it to the remote
+        # end and reference the returned path; archives and base64 bytes travel inline.
+        def web_extension_data(path)
+          return web_extension.extension_base64_encoded(value: encode_extension(path)) unless File.directory?(path)
+
+          path = upload(path) if respond_to?(:upload)
+          web_extension.extension_path(path: path)
+        end
+
         def readiness_state
           READINESS_STATE.fetch(capabilities[:page_load_strategy] || 'normal')
         end

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

@@ -593,14 +593,18 @@ module Selenium
           execute :click_fedcm_dialog_button, {}, {dialogButton: 'ConfirmIdpLoginContinue'}
         end
 
-        def bidi
-          msg = 'BiDi must be enabled by setting #web_socket_url to true in options class'
-          raise(WebDriver::Error::WebDriverError, msg)
+        def bidi(*)
+          raise WebDriver::Error::WebDriverError,
+                'BiDi must be enabled by setting #web_socket_url to true in options class'
         end
+        alias connection bidi
+        alias web_extension bidi
+        alias install_web_extension bidi
+        alias uninstall_web_extension bidi
+        private :web_extension
 
-        def connection
-          msg = 'BiDi must be enabled by setting #web_socket_url to true in options class'
-          raise(WebDriver::Error::WebDriverError, msg)
+        def bidi?
+          !@bidi.nil?
         end
 
         def command_list
@@ -609,6 +613,16 @@ module Selenium
 
         private
 
+        def encode_extension(path)
+          if File.directory?(path)
+            Zipper.zip(path)
+          elsif File.file?(path)
+            File.open(path, 'rb') { |file| Base64.strict_encode64(file.read) }
+          else
+            path # already base64-encoded bytes
+          end
+        end
+
         #
         # executes a command on the remote server.
         #

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

@@ -42,20 +42,21 @@ module Selenium
         end
 
         def upload(local_file)
-          unless File.file?(local_file)
-            WebDriver.logger.error("File detector only works with files. #{local_file.inspect} isn`t a file!",
-                                   id: :file_detector)
-            raise Error::WebDriverError, "You are trying to upload something that isn't a file."
-          end
-
-          execute :upload_file, {}, {file: Zipper.zip_file(local_file)}
+          execute :upload_file, {}, {file: Zipper.zip_root(local_file)}
         end
 
         def upload_if_necessary(keys)
           local_files = keys.first&.split("\n")&.filter_map { |key| @file_detector.call(Array(key)) }
           return keys unless local_files&.any?
 
-          keys = local_files.map { |local_file| upload(local_file) }
+          keys = local_files.map do |local_file|
+            unless File.file?(local_file)
+              WebDriver.logger.error("File detector only works with files. #{local_file.inspect} isn`t a file!",
+                                     id: :file_detector)
+              raise Error::WebDriverError, "You are trying to upload something that isn't a file."
+            end
+            upload(local_file)
+          end
           Array(keys.join("\n"))
         end
 

data/lib/selenium/webdriver/version.rb

@@ -19,6 +19,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '4.49.0'
+    VERSION = '4.50.0'
   end # WebDriver
 end # Selenium

data/selenium-webdriver.gemspec

@@ -51,7 +51,6 @@ 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', '< 4.0']
   s.add_dependency 'websocket', ['~> 1.0']
 

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 4.49.0
+  version: 4.50.0
 platform: ruby
 authors:
 - Alex Rodionov
 - Titus Fortner
 - Thomas Walpole
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-09-09 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -40,26 +39,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.4'
-- !ruby/object:Gem::Dependency
-  name: rexml
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.2.5
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 3.2.5
 - !ruby/object:Gem::Dependency
   name: rubyzip
   requirement: !ruby/object:Gem::Requirement
@@ -303,11 +282,14 @@ files:
 - lib/selenium/webdriver/bidi/protocol/bluetooth.rb
 - lib/selenium/webdriver/bidi/protocol/browser.rb
 - lib/selenium/webdriver/bidi/protocol/browsing_context.rb
+- lib/selenium/webdriver/bidi/protocol/digital_credentials.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/moz_debugging.rb
+- lib/selenium/webdriver/bidi/protocol/moz_profiler.rb
 - lib/selenium/webdriver/bidi/protocol/network.rb
 - lib/selenium/webdriver/bidi/protocol/permissions.rb
 - lib/selenium/webdriver/bidi/protocol/script.rb
@@ -418,6 +400,7 @@ files:
 - lib/selenium/webdriver/common/virtual_authenticator/virtual_authenticator.rb
 - lib/selenium/webdriver/common/virtual_authenticator/virtual_authenticator_options.rb
 - lib/selenium/webdriver/common/wait.rb
+- lib/selenium/webdriver/common/web_extension.rb
 - lib/selenium/webdriver/common/websocket_connection.rb
 - lib/selenium/webdriver/common/window.rb
 - lib/selenium/webdriver/common/zipper.rb
@@ -437,7 +420,6 @@ files:
 - lib/selenium/webdriver/edge/service.rb
 - lib/selenium/webdriver/firefox.rb
 - lib/selenium/webdriver/firefox/driver.rb
-- lib/selenium/webdriver/firefox/extension.rb
 - lib/selenium/webdriver/firefox/features.rb
 - lib/selenium/webdriver/firefox/options.rb
 - lib/selenium/webdriver/firefox/profile.rb
@@ -490,7 +472,6 @@ metadata:
   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:
 - lib
@@ -505,8 +486,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Selenium is a browser automation tool for automated testing of webapps and
   more