selenium-webdriver 4.51.0 → 4.53.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (44) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGES +26 -0
  3. data/Gemfile +14 -0
  4. data/README.md +20 -0
  5. data/bin/linux-arm64/selenium-manager +0 -0
  6. data/bin/linux-x86_64/selenium-manager +0 -0
  7. data/bin/macos/selenium-manager +0 -0
  8. data/bin/selenium-manager-THIRD-PARTY-NOTICES.txt +620 -263
  9. data/bin/selenium-manager.cdx.json +1187 -1180
  10. data/bin/windows/selenium-manager.exe +0 -0
  11. data/lib/selenium/server.rb +27 -75
  12. data/lib/selenium/webdriver/atoms/findElements.js +960 -250
  13. data/lib/selenium/webdriver/atoms/getAttribute.js +153 -127
  14. data/lib/selenium/webdriver/atoms/isDisplayed.js +433 -364
  15. data/lib/selenium/webdriver/atoms.rb +4 -1
  16. data/lib/selenium/webdriver/bidi/protocol/bluetooth.rb +6 -6
  17. data/lib/selenium/webdriver/bidi/protocol/browser.rb +21 -9
  18. data/lib/selenium/webdriver/bidi/protocol/browsing_context.rb +109 -39
  19. data/lib/selenium/webdriver/bidi/protocol/emulation.rb +89 -44
  20. data/lib/selenium/webdriver/bidi/protocol/input.rb +95 -31
  21. data/lib/selenium/webdriver/bidi/protocol/log.rb +4 -4
  22. data/lib/selenium/webdriver/bidi/protocol/moz_debugging.rb +12 -10
  23. data/lib/selenium/webdriver/bidi/protocol/moz_profiler.rb +4 -4
  24. data/lib/selenium/webdriver/bidi/protocol/network.rb +82 -39
  25. data/lib/selenium/webdriver/bidi/protocol/permissions.rb +3 -0
  26. data/lib/selenium/webdriver/bidi/protocol/script.rb +38 -24
  27. data/lib/selenium/webdriver/bidi/protocol/session.rb +80 -8
  28. data/lib/selenium/webdriver/bidi/protocol/storage.rb +3 -3
  29. data/lib/selenium/webdriver/bidi/protocol/user_agent_client_hints.rb +3 -3
  30. data/lib/selenium/webdriver/bidi/protocol/web_extension.rb +17 -9
  31. data/lib/selenium/webdriver/bidi/serialization/record.rb +66 -24
  32. data/lib/selenium/webdriver/bidi/serialization.rb +2 -2
  33. data/lib/selenium/webdriver/bidi/support/bidi_generate.rb +228 -150
  34. data/lib/selenium/webdriver/common/child_process.rb +3 -2
  35. data/lib/selenium/webdriver/common/client_config.rb +4 -1
  36. data/lib/selenium/webdriver/common/driver_finder.rb +5 -2
  37. data/lib/selenium/webdriver/common/service.rb +6 -2
  38. data/lib/selenium/webdriver/common/service_manager.rb +2 -0
  39. data/lib/selenium/webdriver/common/websocket_connection.rb +59 -18
  40. data/lib/selenium/webdriver/remote/http/default.rb +17 -1
  41. data/lib/selenium/webdriver/safari/service.rb +1 -1
  42. data/lib/selenium/webdriver/version.rb +1 -1
  43. data/selenium-webdriver.gemspec +0 -12
  44. metadata +6 -163
@@ -97,8 +97,11 @@ module Selenium
97
97
  args << @options.binary.gsub('\\', '\\\\\\')
98
98
  end
99
99
  if @options.proxy
100
- args << '--proxy'
101
- args << (@options.proxy.ssl || @options.proxy.http)
100
+ proxy = @options.proxy.ssl || @options.proxy.http
101
+ if proxy
102
+ args << '--proxy'
103
+ args << proxy
104
+ end
102
105
  end
103
106
  args
104
107
  end
@@ -57,16 +57,19 @@ module Selenium
57
57
  end
58
58
  end
59
59
 
60
- attr_accessor :host, :executable_path, :port, :log, :args
60
+ attr_accessor :host, :executable_path, :port, :log, :args, :env
61
61
  alias extra_args args
62
62
 
63
63
  #
64
64
  # End users should use a class method for the desired driver, rather than using this directly.
65
65
  #
66
+ # @param env [Hash<String, String, nil>] environment variables for the driver process.
67
+ # These are merged into the inherited environment; set a value to nil to remove an inherited variable.
68
+ #
66
69
  # @api private
67
70
  #
68
71
 
69
- def initialize(path: nil, port: nil, log: nil, args: nil)
72
+ def initialize(path: nil, port: nil, log: nil, args: nil, env: nil)
70
73
  port ||= self.class::DEFAULT_PORT
71
74
  args ||= []
72
75
 
@@ -82,6 +85,7 @@ module Selenium
82
85
  log
83
86
  end
84
87
  @args = args
88
+ @env = env || {}
85
89
 
86
90
  raise Error::WebDriverError, "invalid port: #{@port}" if @port < 1
87
91
  end
@@ -42,6 +42,7 @@ module Selenium
42
42
  @port = config.port
43
43
  @io = config.log
44
44
  @extra_args = config.args
45
+ @env = config.env
45
46
  @shutdown_supported = config.shutdown_supported
46
47
 
47
48
  raise Error::WebDriverError, "invalid port: #{@port}" if @port < 1
@@ -80,6 +81,7 @@ module Selenium
80
81
  def build_process(*command)
81
82
  WebDriver.logger.debug("Executing Process #{command}", id: :driver_service)
82
83
  @process = ChildProcess.build(*command)
84
+ @process.env = @env
83
85
  if ENV.key?('SE_DEBUG')
84
86
  if @io && @io != WebDriver.logger.io
85
87
  WebDriver.logger.warn('SE_DEBUG is set; overriding user-specified driver log output to use stderr',
@@ -103,22 +103,30 @@ module Selenium
103
103
  # IOError to match what writing to an already-closed socket raises
104
104
  raise IOError, 'WebSocket connection is closed' if @closing
105
105
 
106
- id = next_id
107
- data = payload.merge(id: id)
108
- WebDriver.logger.debug('WebSocket ->', id: :ws) { data.to_s[...MAX_LOG_MESSAGE_SIZE] }
109
- data = JSON.generate(data)
110
- out_frame = WebSocket::Frame::Outgoing::Client.new(version: ws.version, data: data, type: 'text')
111
-
112
- begin
113
- socket.write(out_frame.to_s)
114
- rescue *CONNECTION_ERRORS => e
115
- raise e, "WebSocket is closed (#{e.class}: #{e.message})"
106
+ # Callbacks send commands from their own threads, so the id must be
107
+ # allocated and registered atomically or two commands can share one
108
+ id = @messages_mtx.synchronize do
109
+ next_id.tap { |new_id| pending_responses[new_id] = ConditionVariable.new }
116
110
  end
117
111
 
118
- wait.until do
119
- raise IOError, 'WebSocket connection closed while waiting for a response' if @closing
112
+ begin
113
+ data = payload.merge(id: id)
114
+ WebDriver.logger.debug('WebSocket ->', id: :ws) { data.to_s[...MAX_LOG_MESSAGE_SIZE] }
115
+ data = JSON.generate(data)
116
+ out_frame = WebSocket::Frame::Outgoing::Client.new(version: ws.version, data: data, type: 'text')
117
+
118
+ begin
119
+ socket.write(out_frame.to_s)
120
+ rescue *CONNECTION_ERRORS => e
121
+ raise e, "WebSocket is closed (#{e.class}: #{e.message})"
122
+ end
120
123
 
121
- @messages_mtx.synchronize { messages.delete(id) }
124
+ await_response(id)
125
+ ensure
126
+ @messages_mtx.synchronize do
127
+ pending_responses.delete(id)
128
+ messages.delete(id)
129
+ end
122
130
  end
123
131
  end
124
132
 
@@ -128,6 +136,30 @@ module Selenium
128
136
  @messages ||= {}
129
137
  end
130
138
 
139
+ def pending_responses
140
+ @pending_responses ||= {}
141
+ end
142
+
143
+ def await_response(id)
144
+ deadline = Process.clock_gettime(Process::CLOCK_MONOTONIC) + RESPONSE_WAIT_TIMEOUT
145
+ @messages_mtx.synchronize do
146
+ until messages.key?(id)
147
+ raise IOError, 'WebSocket connection closed while waiting for a response' if @closing
148
+
149
+ remaining = deadline - Process.clock_gettime(Process::CLOCK_MONOTONIC)
150
+ raise Error::TimeoutError, "timed out after #{RESPONSE_WAIT_TIMEOUT} seconds" if remaining <= 0
151
+
152
+ pending_responses[id].wait(@messages_mtx, remaining)
153
+ end
154
+ messages.delete(id)
155
+ end
156
+ end
157
+
158
+ # Once the socket is closed no reply can arrive, so wake waiters instead of letting them run out the timeout
159
+ def release_pending_responses
160
+ @messages_mtx.synchronize { pending_responses.each_value(&:broadcast) }
161
+ end
162
+
131
163
  def process_handshake
132
164
  socket.print(ws.to_s)
133
165
  ws << socket.readpartial(1024) until ws.finished?
@@ -147,6 +179,9 @@ module Selenium
147
179
  end
148
180
  rescue *CONNECTION_ERRORS, WebSocket::Error => e
149
181
  WebDriver.logger.debug "WebSocket listener closed: #{e.class}: #{e.message}", id: :ws
182
+ ensure
183
+ # Nothing reads replies once the listener stops, however it stopped
184
+ close_socket
150
185
  end
151
186
  end
152
187
 
@@ -155,6 +190,8 @@ module Selenium
155
190
  socket.close
156
191
  rescue *CONNECTION_ERRORS => e
157
192
  WebDriver.logger.debug "WebSocket socket closed: #{e.class}: #{e.message}", id: :ws
193
+ ensure
194
+ release_pending_responses
158
195
  end
159
196
 
160
197
  def process_incoming_frames
@@ -198,7 +235,15 @@ module Selenium
198
235
  return {} if message.empty?
199
236
 
200
237
  msg = JSON.parse(message)
201
- @messages_mtx.synchronize { messages[msg['id']] = msg if msg.key?('id') }
238
+ if msg.key?('id')
239
+ @messages_mtx.synchronize do
240
+ # Replies to commands that already timed out are dropped so they don't accumulate
241
+ if (waiter = pending_responses[msg['id']])
242
+ messages[msg['id']] = msg
243
+ waiter.signal
244
+ end
245
+ end
246
+ end
202
247
 
203
248
  WebDriver.logger.debug('WebSocket <-', id: :ws) { msg.to_s[...MAX_LOG_MESSAGE_SIZE] }
204
249
  msg
@@ -221,10 +266,6 @@ module Selenium
221
266
  end
222
267
  end
223
268
 
224
- def wait
225
- @wait ||= Wait.new(timeout: RESPONSE_WAIT_TIMEOUT, interval: RESPONSE_WAIT_INTERVAL)
226
- end
227
-
228
269
  def socket
229
270
  @socket ||= if URI(@url).scheme == 'wss'
230
271
  socket = TCPSocket.new(ws.host, ws.port)
@@ -72,7 +72,11 @@ module Selenium
72
72
  http = new_http_client
73
73
  if server_url.scheme == 'https'
74
74
  http.use_ssl = true
75
- http.verify_mode = OpenSSL::SSL::VERIFY_NONE
75
+ http.verify_mode = if client_config.ignore_certificates
76
+ OpenSSL::SSL::VERIFY_NONE
77
+ else
78
+ OpenSSL::SSL::VERIFY_PEER
79
+ end
76
80
  end
77
81
 
78
82
  http.open_timeout = open_timeout if open_timeout
@@ -85,6 +89,18 @@ module Selenium
85
89
 
86
90
  def start(http)
87
91
  http.start
92
+ rescue OpenSSL::SSL::SSLError => e
93
+ failure = e.message.match(/certificate verify failed(?: \((.+?)\))?/)
94
+ raise unless failure
95
+
96
+ raise e.class, unverified_certificate_message(failure[1] || failure[0]), e.backtrace
97
+ end
98
+
99
+ def unverified_certificate_message(reason)
100
+ location = server_url.dup.tap { |url| url.user = nil }
101
+ "Cannot verify the certificate for #{location} (#{reason}). " \
102
+ 'Trust its issuer if it is self-signed or from a private CA, ' \
103
+ 'or skip verification with ignore_certificates: true on a ClientConfig passed to the driver constructor'
88
104
  end
89
105
 
90
106
  MAX_RETRIES = 3
@@ -25,7 +25,7 @@ module Selenium
25
25
  EXECUTABLE = 'safaridriver'
26
26
  SHUTDOWN_SUPPORTED = false
27
27
  DRIVER_PATH_ENV_KEY = 'SE_SAFARIDRIVER'
28
- def initialize(path: nil, port: nil, log: nil, args: nil)
28
+ def initialize(path: nil, port: nil, log: nil, args: nil, env: nil)
29
29
  raise Error::WebDriverError, 'Safari Service does not support setting log output' if log
30
30
 
31
31
  super
@@ -19,6 +19,6 @@
19
19
 
20
20
  module Selenium
21
21
  module WebDriver
22
- VERSION = '4.51.0'
22
+ VERSION = '4.53.0'
23
23
  end # WebDriver
24
24
  end # Selenium
@@ -53,16 +53,4 @@ Gem::Specification.new do |s|
53
53
  s.add_dependency 'logger', ['~> 1.4']
54
54
  s.add_dependency 'rubyzip', ['>= 1.2.2', '< 4.0']
55
55
  s.add_dependency 'websocket', ['~> 1.0']
56
-
57
- s.add_development_dependency 'git', ['~> 1.19']
58
- s.add_development_dependency 'rack', ['~> 2.0']
59
- s.add_development_dependency 'rake', ['~> 13.0']
60
- s.add_development_dependency 'rspec', ['~> 3.0']
61
- s.add_development_dependency 'rubocop', ['~> 1.75']
62
- s.add_development_dependency 'rubocop-performance', ['~> 1.25']
63
- s.add_development_dependency 'rubocop-rake', ['~> 0.7']
64
- s.add_development_dependency 'rubocop-rspec', ['~> 3.5']
65
- s.add_development_dependency 'webmock', ['~> 3.5']
66
- s.add_development_dependency 'webrick', ['~> 1.7']
67
- s.add_development_dependency 'yard', ['~> 0.9.11', '>= 0.9.36']
68
56
  end
metadata CHANGED
@@ -1,15 +1,16 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: selenium-webdriver
3
3
  version: !ruby/object:Gem::Version
4
- version: 4.51.0
4
+ version: 4.53.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Alex Rodionov
8
8
  - Titus Fortner
9
9
  - Thomas Walpole
10
+ autorequire:
10
11
  bindir: bin
11
12
  cert_chain: []
12
- date: 1980-01-02 00:00:00.000000000 Z
13
+ date: 2026-11-17 00:00:00.000000000 Z
13
14
  dependencies:
14
15
  - !ruby/object:Gem::Dependency
15
16
  name: base64
@@ -73,166 +74,6 @@ dependencies:
73
74
  - - "~>"
74
75
  - !ruby/object:Gem::Version
75
76
  version: '1.0'
76
- - !ruby/object:Gem::Dependency
77
- name: git
78
- requirement: !ruby/object:Gem::Requirement
79
- requirements:
80
- - - "~>"
81
- - !ruby/object:Gem::Version
82
- version: '1.19'
83
- type: :development
84
- prerelease: false
85
- version_requirements: !ruby/object:Gem::Requirement
86
- requirements:
87
- - - "~>"
88
- - !ruby/object:Gem::Version
89
- version: '1.19'
90
- - !ruby/object:Gem::Dependency
91
- name: rack
92
- requirement: !ruby/object:Gem::Requirement
93
- requirements:
94
- - - "~>"
95
- - !ruby/object:Gem::Version
96
- version: '2.0'
97
- type: :development
98
- prerelease: false
99
- version_requirements: !ruby/object:Gem::Requirement
100
- requirements:
101
- - - "~>"
102
- - !ruby/object:Gem::Version
103
- version: '2.0'
104
- - !ruby/object:Gem::Dependency
105
- name: rake
106
- requirement: !ruby/object:Gem::Requirement
107
- requirements:
108
- - - "~>"
109
- - !ruby/object:Gem::Version
110
- version: '13.0'
111
- type: :development
112
- prerelease: false
113
- version_requirements: !ruby/object:Gem::Requirement
114
- requirements:
115
- - - "~>"
116
- - !ruby/object:Gem::Version
117
- version: '13.0'
118
- - !ruby/object:Gem::Dependency
119
- name: rspec
120
- requirement: !ruby/object:Gem::Requirement
121
- requirements:
122
- - - "~>"
123
- - !ruby/object:Gem::Version
124
- version: '3.0'
125
- type: :development
126
- prerelease: false
127
- version_requirements: !ruby/object:Gem::Requirement
128
- requirements:
129
- - - "~>"
130
- - !ruby/object:Gem::Version
131
- version: '3.0'
132
- - !ruby/object:Gem::Dependency
133
- name: rubocop
134
- requirement: !ruby/object:Gem::Requirement
135
- requirements:
136
- - - "~>"
137
- - !ruby/object:Gem::Version
138
- version: '1.75'
139
- type: :development
140
- prerelease: false
141
- version_requirements: !ruby/object:Gem::Requirement
142
- requirements:
143
- - - "~>"
144
- - !ruby/object:Gem::Version
145
- version: '1.75'
146
- - !ruby/object:Gem::Dependency
147
- name: rubocop-performance
148
- requirement: !ruby/object:Gem::Requirement
149
- requirements:
150
- - - "~>"
151
- - !ruby/object:Gem::Version
152
- version: '1.25'
153
- type: :development
154
- prerelease: false
155
- version_requirements: !ruby/object:Gem::Requirement
156
- requirements:
157
- - - "~>"
158
- - !ruby/object:Gem::Version
159
- version: '1.25'
160
- - !ruby/object:Gem::Dependency
161
- name: rubocop-rake
162
- requirement: !ruby/object:Gem::Requirement
163
- requirements:
164
- - - "~>"
165
- - !ruby/object:Gem::Version
166
- version: '0.7'
167
- type: :development
168
- prerelease: false
169
- version_requirements: !ruby/object:Gem::Requirement
170
- requirements:
171
- - - "~>"
172
- - !ruby/object:Gem::Version
173
- version: '0.7'
174
- - !ruby/object:Gem::Dependency
175
- name: rubocop-rspec
176
- requirement: !ruby/object:Gem::Requirement
177
- requirements:
178
- - - "~>"
179
- - !ruby/object:Gem::Version
180
- version: '3.5'
181
- type: :development
182
- prerelease: false
183
- version_requirements: !ruby/object:Gem::Requirement
184
- requirements:
185
- - - "~>"
186
- - !ruby/object:Gem::Version
187
- version: '3.5'
188
- - !ruby/object:Gem::Dependency
189
- name: webmock
190
- requirement: !ruby/object:Gem::Requirement
191
- requirements:
192
- - - "~>"
193
- - !ruby/object:Gem::Version
194
- version: '3.5'
195
- type: :development
196
- prerelease: false
197
- version_requirements: !ruby/object:Gem::Requirement
198
- requirements:
199
- - - "~>"
200
- - !ruby/object:Gem::Version
201
- version: '3.5'
202
- - !ruby/object:Gem::Dependency
203
- name: webrick
204
- requirement: !ruby/object:Gem::Requirement
205
- requirements:
206
- - - "~>"
207
- - !ruby/object:Gem::Version
208
- version: '1.7'
209
- type: :development
210
- prerelease: false
211
- version_requirements: !ruby/object:Gem::Requirement
212
- requirements:
213
- - - "~>"
214
- - !ruby/object:Gem::Version
215
- version: '1.7'
216
- - !ruby/object:Gem::Dependency
217
- name: yard
218
- requirement: !ruby/object:Gem::Requirement
219
- requirements:
220
- - - "~>"
221
- - !ruby/object:Gem::Version
222
- version: 0.9.11
223
- - - ">="
224
- - !ruby/object:Gem::Version
225
- version: 0.9.36
226
- type: :development
227
- prerelease: false
228
- version_requirements: !ruby/object:Gem::Requirement
229
- requirements:
230
- - - "~>"
231
- - !ruby/object:Gem::Version
232
- version: 0.9.11
233
- - - ">="
234
- - !ruby/object:Gem::Version
235
- version: 0.9.36
236
77
  description: |2
237
78
  Selenium implements the W3C WebDriver protocol to automate popular browsers.
238
79
  It aims to mimic the behaviour of a real user as it interacts with the application's HTML.
@@ -472,6 +313,7 @@ metadata:
472
313
  source_code_uri: https://github.com/SeleniumHQ/selenium/tree/trunk/rb
473
314
  rubygems_mfa_required: 'true'
474
315
  funding_uri: https://github.com/sponsors/SeleniumHQ
316
+ post_install_message:
475
317
  rdoc_options: []
476
318
  require_paths:
477
319
  - lib
@@ -486,7 +328,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
486
328
  - !ruby/object:Gem::Version
487
329
  version: 1.3.1
488
330
  requirements: []
489
- rubygems_version: 4.0.3
331
+ rubygems_version: 3.5.22
332
+ signing_key:
490
333
  specification_version: 4
491
334
  summary: Selenium is a browser automation tool for automated testing of webapps and
492
335
  more