[rb] add ClientConfig for HTTP client customization#17699
Open
titusfortner wants to merge 2 commits into
Open
Conversation
Contributor
PR Summary by QodoAdd ClientConfig to centralize Ruby HTTP client customization Description
Diagram
High-Level Assessment
Files changed (37)
|
Contributor
Code Review by Qodo
Context used✅ Compliance rules (platform):
19 rules 1.
|
![qodo-code-review[bot]](https://avatars.githubusercontent.com/in/484649?s=60&v=4){kind=small}
Contributor
|
Code review by qodo was updated up to the latest commit 8f5d153 |
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a Ruby ClientConfig object to centralize HTTP client settings (timeouts, redirects, proxy, headers, user-agent, server URL), and refactors driver/bridge construction so the Bridge only consumes a configured http_client.
Changes:
- Introduces
Selenium::WebDriver::ClientConfigwith defaults (including read timeout 120s) and environment proxy support. - Updates local + remote driver constructors to accept
client_config:(mutually exclusive withhttp_client:) and to pass only an HTTP client into the Bridge. - Updates unit tests and RBS signatures for the new constructor shapes and config behavior.
Reviewed changes
Copilot reviewed 37 out of 37 changed files in this pull request and generated 5 comments.
Show a summary per file
| File | Description |
|---|---|
| rb/spec/unit/selenium/webdriver/safari/service_spec.rb | Updates expected error message when :url is provided for a local driver. |
| rb/spec/unit/selenium/webdriver/remote/http/default_spec.rb | Updates timeout defaults and adds coverage for ClientConfig + redirect limits. |
| rb/spec/unit/selenium/webdriver/remote/http/common_spec.rb | Shifts header/user-agent expectations to ClientConfig defaults. |
| rb/spec/unit/selenium/webdriver/remote/features_spec.rb | Updates Bridge construction to rely on http_client.server_url. |
| rb/spec/unit/selenium/webdriver/remote/driver_spec.rb | Adds coverage for client_config in remote driver initialization and conflicts. |
| rb/spec/unit/selenium/webdriver/remote/bridge_spec.rb | Updates Bridge initialization expectations (now http_client: only). |
| rb/spec/unit/selenium/webdriver/ie/service_spec.rb | Updates expected error message when :url is provided for a local driver. |
| rb/spec/unit/selenium/webdriver/firefox/service_spec.rb | Updates expected error message when :url is provided for a local driver. |
| rb/spec/unit/selenium/webdriver/edge/service_spec.rb | Updates expected error message when :url is provided for a local driver. |
| rb/spec/unit/selenium/webdriver/chrome/service_spec.rb | Updates expected error message when :url is provided for a local driver. |
| rb/spec/unit/selenium/webdriver/chrome/driver_spec.rb | Adds coverage for rejecting client_config.server_url on local drivers and conflict handling. |
| rb/sig/lib/selenium/webdriver/safari/driver.rbs | Updates Safari driver initializer signature with http_client/client_config. |
| rb/sig/lib/selenium/webdriver/remote/http/default.rbs | Updates Http::Default initializer and accessors signatures. |
| rb/sig/lib/selenium/webdriver/remote/http/common.rbs | Updates Http::Common to accept client_config: and return URI server_url. |
| rb/sig/lib/selenium/webdriver/remote/driver.rbs | Updates Remote driver initializer signature with http_client/client_config. |
| rb/sig/lib/selenium/webdriver/remote/bridge.rbs | Updates Bridge initializer signature (now only http_client:). |
| rb/sig/lib/selenium/webdriver/ie/driver.rbs | Updates IE driver initializer signature with http_client/client_config. |
| rb/sig/lib/selenium/webdriver/firefox/driver.rbs | Updates Firefox driver initializer signature with http_client/client_config. |
| rb/sig/lib/selenium/webdriver/edge/driver.rbs | Updates Edge driver initializer signature with http_client/client_config. |
| rb/sig/lib/selenium/webdriver/common/local_driver.rbs | Updates LocalDriver helper signatures for new parameters. |
| rb/sig/lib/selenium/webdriver/common/driver.rbs | Updates create_bridge signature (drops url:). |
| rb/sig/lib/selenium/webdriver/common/client_config.rbs | Adds RBS for the new ClientConfig class. |
| rb/sig/lib/selenium/webdriver/chrome/driver.rbs | Updates Chrome driver initializer signature with http_client/client_config. |
| rb/lib/selenium/webdriver/safari/driver.rb | Passes http_client through local driver initialization into base Driver. |
| rb/lib/selenium/webdriver/remote/http/default.rb | Refactors HTTP default client to be backed by ClientConfig and to use config for redirects/proxy/timeouts. |
| rb/lib/selenium/webdriver/remote/http/common.rb | Moves per-instance headers/user-agent and server URL storage into ClientConfig. |
| rb/lib/selenium/webdriver/remote/driver.rb | Allows client_config: to build/configure the HTTP client and enforces exclusivity with http_client:. |
| rb/lib/selenium/webdriver/remote/bridge.rb | Removes url: from Bridge initialization; uses provided configured HTTP client. |
| rb/lib/selenium/webdriver/ie/driver.rb | Passes http_client through local driver initialization into base Driver. |
| rb/lib/selenium/webdriver/firefox/driver.rb | Passes http_client through local driver initialization into base Driver. |
| rb/lib/selenium/webdriver/edge/driver.rb | Passes http_client through local driver initialization into base Driver. |
| rb/lib/selenium/webdriver/common/local_driver.rb | Builds/configures HTTP client for local services and validates url/config conflicts. |
| rb/lib/selenium/webdriver/common/driver.rb | Updates bridge creation to only pass http_client:. |
| rb/lib/selenium/webdriver/common/client_config.rb | Adds the new ClientConfig implementation and defaults. |
| rb/lib/selenium/webdriver/common.rb | Requires the new ClientConfig. |
| rb/lib/selenium/webdriver/chrome/driver.rb | Passes http_client through local driver initialization into base Driver. |
| rb/.rubocop.yml | Updates RuboCop parameter list metrics config. |
Comment on lines
+78
to
+85
| def proxy_from_environment | ||
| proxy = ENV.fetch('http_proxy', nil) || ENV.fetch('HTTP_PROXY', nil) | ||
| return unless proxy | ||
|
|
||
| no_proxy = ENV.fetch('no_proxy', nil) || ENV.fetch('NO_PROXY', nil) | ||
| proxy = "http://#{proxy}" unless proxy.start_with?('http://') | ||
| Proxy.new(http: proxy, no_proxy: no_proxy) | ||
| end |
Comment on lines
+66
to
+74
| def server_url=(url) | ||
| if url.nil? | ||
| @server_url = nil | ||
| else | ||
| url = url.to_s | ||
| url += '/' unless url.end_with?('/') | ||
| @server_url = URI.parse(url) | ||
| end | ||
| end |
Comment on lines
36
to
+40
| raise ArgumentError, "Can not set :service object on #{self.class}" if service | ||
| raise Error::WebDriverError, 'Cannot use both :http_client and :client_config' if http_client && client_config | ||
|
|
||
| url ||= "http://#{Platform.localhost}:4444/wd/hub" | ||
| caps = process_options(options, capabilities) | ||
| super(caps: caps, url: url, **) | ||
| http_client ||= Remote::Http::Default.new(client_config: client_config) |
Comment on lines
+9
to
+24
| attr_accessor open_timeout: Integer? | ||
| attr_accessor read_timeout: Integer? | ||
| attr_accessor max_redirects: Integer? | ||
| attr_accessor proxy: Selenium::WebDriver::Proxy? | ||
| def extra_headers: -> Hash[String, String]? | ||
| attr_writer extra_headers: Hash[String, String]? | ||
| def user_agent: -> String | ||
| attr_writer user_agent: String? | ||
| attr_reader server_url: URI? | ||
|
|
||
| def server_url=: ((String | URI)? url) -> void | ||
|
|
||
| def initialize: ( | ||
| ?open_timeout: Integer?, | ||
| ?read_timeout: Integer?, | ||
| ?max_redirects: Integer?, |
Comment on lines
+126
to
+131
| def follow_redirect(response, redirects) | ||
| WebDriver.logger.debug("Redirect to #{response['Location']}; times: #{redirects}") | ||
| raise Error::WebDriverError, 'too many redirects' if redirects >= client_config.max_redirects | ||
|
|
||
| request(:get, URI.parse(response['Location']), DEFAULT_HEADERS.dup, nil, redirects + 1) | ||
| end |
aguspe
reviewed
Jun 22, 2026
|
|
||
| def follow_redirect(response, redirects) | ||
| WebDriver.logger.debug("Redirect to #{response['Location']}; times: #{redirects}") | ||
| raise Error::WebDriverError, 'too many redirects' if redirects >= client_config.max_redirects |
Contributor
There was a problem hiding this comment.
@titusfortner how does this affect the curb.rb client? I remember working on it a while ago to add timeouts and it has a MAX_REDIRECTS constant
Member
Author
There was a problem hiding this comment.
I figured since the curb client is deprecated we should just leave it alone. So you can't use client config instance to construct curb client at all.
Curb is subclassing Common, not Default, so all the custom behavior in Default won't apply. The changes in Common should be completely backwards compatible for existing curb users, though.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
🔗 Related Issues
Implements Ruby portion of #12368 and replaces previous implementation #16486
💥 What does this PR do?
ClientConfigfor Ruby that centralizes HTTP transport settings for: open/read timeouts, max redirects, proxy, extra headers, user-agent, and server URLClientConfigowns the defaults🔧 Implementation Notes
Dataclass, but that's the wrong approach; this should take the same approach as Options allowing setting values after creation before usage🤖 AI assistance
💡 Additional Considerations
Http::Commonclass methods in favor of ClientConfig class methodsClientConfigis positioned to carry the WebSocket settings for the BiDi follow-up.🔄 Types of changes