[rb] Support overriding User-Agent in HTTP client

Author: p0deje

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

@@ -26,12 +26,16 @@ class Common
           CONTENT_TYPE    = 'application/json'
           DEFAULT_HEADERS = {
             'Accept' => CONTENT_TYPE,
-            'Content-Type' => "#{CONTENT_TYPE}; charset=UTF-8",
-            'User-Agent' => "selenium/#{WebDriver::VERSION} (ruby #{Platform.os})"
+            'Content-Type' => "#{CONTENT_TYPE}; charset=UTF-8"
           }.freeze
 
           class << self
             attr_accessor :extra_headers
+            attr_writer :user_agent
+
+            def user_agent
+              @user_agent ||= "selenium/#{WebDriver::VERSION} (ruby #{Platform.os})"
+            end
           end
 
           attr_writer :server_url
@@ -46,7 +50,7 @@ def close
 
           def call(verb, url, command_hash)
             url      = server_url.merge(url) unless url.is_a?(URI)
-            headers  = DEFAULT_HEADERS.merge(Common.extra_headers || {}).dup
+            headers  = common_headers.dup
             headers['Cache-Control'] = 'no-cache' if verb == :get
 
             if command_hash
@@ -65,6 +69,16 @@ def call(verb, url, command_hash)
 
           private
 
+          def common_headers
+            @common_headers ||= begin
+              headers = DEFAULT_HEADERS.dup
+              headers['User-Agent'] = Common.user_agent
+              headers = headers.merge(Common.extra_headers || {})
+
+              headers
+            end
+          end
+
           def server_url
             return @server_url if @server_url
 

rb/spec/unit/selenium/webdriver/remote/http/common_spec.rb

@@ -33,7 +33,8 @@ module Http
           end
 
           after do
-            described_class.extra_headers = {}
+            described_class.extra_headers = nil
+            described_class.user_agent = nil
           end
 
           it 'sends non-empty body header for POST requests without command data' do
@@ -63,6 +64,16 @@ module Http
               .with(:post, URI.parse('http://server/session'),
                     hash_including('Foo' => 'bar'), '{}')
           end
+
+          it 'allows overriding default User-Agent' do
+            described_class.user_agent = 'rspec/1.0 (ruby 3.2)'
+
+            common.call(:post, 'session', nil)
+
+            expect(common).to have_received(:request)
+              .with(:post, URI.parse('http://server/session'),
+                    hash_including('User-Agent' => 'rspec/1.0 (ruby 3.2)'), '{}')
+          end
         end
       end # Http
     end # Remote