/
CHANGES
2370 lines (1867 loc) · 81.5 KB
/
CHANGES
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
4.20.1 (2024-04-25)
=========================
* Returned accidentally removed DriverFinder.path and deprecated it.
4.20.0 (2024-04-24)
=========================
* Add CDP for Chrome 124 and remove 121
* Making Selenium Manager a thin wrapper (#13386)
* This change has been made to make it easier to maintain and improve, the interface has
changed and if users were invoking it, they might experience issues. Selenium Manager is
still in beta and these type of changes are expected.
4.19.0 (2024-03-27)
=========================
* Add CDP for Chrome 123 and remove 120
* Avoid over-escaping browser path (#13632)
* Add full RBS support (#13234)
4.18.1 (2024-02-19)
=========================
* Add CDP for Chrome 122 and remove 119
4.18.0 (2024-02-19)
=========================
* Update documentation link in readme (#13570)
* make suggested updates from rubocop
4.17.0 (2024-01-22)
=========================
* Logger defaults output to stderr instead of stdout
* Fully support Chrome 120+ old headless mode (#13271)
* Add ruby to Selenium Manager input for tracking (see #13288)
* Define default command_list (fixes #13307)
* Fix issues with incorrectly named edge browser
* Check for whether driver supports full page screenshots to error (#12799)
* Add CDP for Chrome 121 and remove 118
4.16.0 (2023-12-06)
=========================
Ruby:
* Add RBS files to Ruby (#12844)
* Convert binary locations for cygwin (#12618)
* Allow Selenium Manager to work with Unix (#13161)
* Extend RBS support for logger and log entry (#13192)
* Update rules_ruby to the latest version (#13235)
BiDi:
* Released selenium-devtools 0.120.0 (supports CDP v85, v118, v119, v120)
Chrome:
* Fix http proxy configuration for chrome (#13093)
Firefox:
* Delete 'lock' file in FF profile (#13090)
4.15.0 (2023-11-01)
=========================
* Do not set browser binary in selenium manager if it is an empty string (#12738)
* Add flaky condition to guards to mark unreliable tests
* Rake update needs to build latest grid for running remote tests
* Add CDP v119 and remove v116
* Implement file downloads (#12979)
4.14.0 (2023-10-09)
=========================
Ruby:
* allow users to access the full script of the atom directly
BiDi:
* Released selenium-devtools 0.118.0 (supports CDP v85, v116, v117, v118)
4.13.1 (2023-09-25)
=========================
Ruby:
* Fix bug preventing logging chromedriver to file
4.13.0 (2023-09-25)
=========================
Ruby:
* Fix bug preventing using performance logging with chromium
* Allow users to set Selenium Manager path by environment variable (#12752)
* Allow service to be started before the driver
* remove deprecated driver extensions for location and network connection
BiDi:
* Released selenium-devtools 0.117.0 (supports CDP v85, v115, v116, v117)
4.12.0 (2023-08-31)
=========================
Ruby:
* Fix bug preventing good error messages in Selenium Manager when stdout empty
* Fix bug with Firefox not loading net/http library by default (#12506)
* Remove support for using capabilities in local drivers
BiDi:
* Released selenium-devtools 0.116.0 (supports CDP v85, v114, v115, v116)
4.11.0 (2023-07-31)
=========================
Ruby:
* Made network interception threads fail silently (#12226)
* Have Selenium Manager binary locate drivers on PATH (#12345)
* Add browser output from selenium manager to options (#12398)
* Remove deprecated code (#12417)
BiDi:
* Released selenium-devtools 0.115.0 (supports CDP v85, v113, v114, v115)
Edge:
* Adding ignore process match for IE Mode across bindings (#12279)
4.10.0 (2023-06-07)
=========================
Ruby:
* Implement proxy support for Selenium Manager
* Prevent setting driver log level in Safari
* Change all Selenium Manager logging to :debug (#12145)
* Error messages include links to documentation
* Add custom error class for driver location and improve error logic
BiDi:
* Released selenium-devtools 0.114.0 (supports CDP v85, v112, v113, v114)
Edge:
* Add support for webview2
4.9.1 (2023-05-08)
=========================
Ruby:
* Allow users to specify driver process output in Service class (#11964)
* Updated minimum required Ruby version to 3.0
* Selenium Logger defaults to :info and all debugging is now logged as :debug (#11967)
* Every logging entry can be ignored based on ID, not just warnings
* Logging entries can be filtered to allow or ignore specific IDs
BiDi:
* Fix bug with loading devtools (#11931) (thanks Boris Petrov!)
* Released selenium-devtools 0.113.0 (supports CDP v85, v111, v112, v113)
4.9.0 (2023-04-21)
=========================
Ruby:
* Fix devtools version fallback (#11869)
* Fix bug in selenium manager escaping back slashes in Windows (#11884)
BiDi:
* Released selenium-devtools 0.112.0 (supports CDP v85, v110, v111, v112)
4.8.6 (2023-03-29)
=========================
Ruby:
* Properly escape arguments passed to Selenium Manager
4.8.5 (2023-03-28)
=========================
Ruby:
* Wrapping browser name in quotes when calling Selenium Manager
4.8.4 (2023-03-28)
=========================
Ruby:
* Update the selenium-manager versions to fix an IE naming issue (#11828)
4.8.3 (2023-03-26)
=========================
Ruby:
* Still need to use driver finder when using capabilities parameter
* Accommodate Driver Finder being sent something other than an Options instance
4.8.2 (2023-03-24)
=========================
Ruby:
* Ruby driver finder (#11523)
* Using json output with Selenium Manager
BiDi:
* Released selenium-devtools 0.111.0 (supports CDP v85, v109, v110, v111)
4.8.1 (2023-02-17)
=========================
Ruby:
* Fix autoload of WebDriver::Remote::Bridge::COMMANDS
* Subclass is setting value before the superclass is setting it to nil
* Updating Selenium Manager binaries for 4.8.1 release
BiDi:
* Released selenium-devtools 0.110.0 (supports CDP v85, v108, v109, v110)
* Close BiDi session on closing the last top-level browsing context
* Add filtering capability to LogInspector
4.8.0 (2023-01-23)
=========================
Ruby:
* Allow updating instance variables on service classes
* Deprecate extract_service_args processing in service classes
* Fix bug preventing sending nil to #send_keys with Remote Driver
* Fix bug with IE specific methods not available to IE Driver
* Created Chromium superclass for Chrome and Edge
* Deprecated platform and version setters/getters in Capabilities class
* Revamped driver constructor logic
* Fix bug preventing using Safari Technology Preview when using SafariOptions
* Fix bug preventing more than one driver type to access Selenium Manager
* Defaults to using Options instead of Capabilities
* Make Options classes more strict for allowed arguments and types
* Removed previously deprecated actions class parameters
* Removed Location struct
* Add comment with name of large JS executions (#11038)
* update logger with link on how to use it (#11478)
* Deprecate #add_option for Option classes in favor of constructor and attr_accessor
* Deprecate all unrecognized capabilities for Options classes
* Deprecate support for :capabilities for local drivers
* Deprecate browser class methods for Capabilities
* Deprecate #headless! for Chrome and Firefox
BiDi:
* Released selenium-devtools 0.109.0 (supports CDP v85, v107, v108, v109)
* Add LogInspector (#11368)
* Add Browsing context commands (#11446)
4.7.1 (2022-12-02)
=========================
Ruby:
* Fix bug preventing selenium manager from using Internet Explorer
4.7.0 (2022-12-01)
=========================
BiDi:
* Released selenium-devtools 0.108.0 (supports CDP v85, v106, v107, v108)
* Fix bug with socket stability
Ruby:
* Remove dependency on ChildProcess gem in favor of native Process.spawn (#11251)
* Add support for Selenium Manager to work with IE Driver
* Improve error handling for Selenium Manager
Safari:
* Fix bug preventing Safari Options from being used with Safari Technology Preview
4.6.1 (2022-11-04)
=========================
Ruby:
* fix bug preventing selenium-manager from being executable by default
4.6.0 (2022-11-04)
=========================
BiDi:
* Released selenium-devtools 0.107.0 (supports CDP v85, v105, v106, v107)
Ruby:
* firefox scroll by amount is only failing on mac
* add initial support for selenium manager
* Revert "[rb] do not allow Select class to work with disabled selects"
* Make sure selenium-manager is packed into gem
* Fix platform list in #scroll_by guard
4.5.0 (2022-09-28)
=========================
BiDi:
* Released selenium-devtools 0.105.0 (supports CDP v85, v103, v104, v105)
* Released selenium-devtools 0.106.0 (supports CDP v85, v104, v105, v106)
* Add HasBiDi support to Chrome
Ruby:
* Fix bug in Platform code
* Update Select class to error when elements are disabled (#10812)
Firefox:
* Add support for installing unsigned add-ons (#10265, thanks TamsilAmani!)
* Change accept_insecure_certificates to true by default (to match other bindings)
* Set debugger_address option to true by default
Server:
* Add support for initializing server class with arguments and log level
4.4.0 (2022-08-09)
=========================
BiDi:
* Released selenium-devtools 0.103.1 to fix websocket dependency requirement
* Released selenium-devtools 0.104.0 (supports CDP v85, v102, v103, v104)
* Have network interceptor ignore cancelled requests (#10856)
* Improve websocket message handling
Chromium:
* Prevent users from setting w3c: false and warn for true (thanks Tamsil Amani!)
Ruby:
* Implement Virtual Authenticator (#10903, #10541) (thanks Tamsil Amani!)
4.3.0 (2022-06-23)
=========================
BiDi:
* Released selenium-devtools 0.103.0 (supports CDP v85, v101, v102, v103)
Ruby:
* Allow specifying which button is clicked in pointer action class methods
* Remove deprecated `Persistent` http class
* Remove deprecated HasRemoteStatus module
* Remove deprecated `Manager#new_window` and `Manager#logs`
* `ActionBuilder#move_to` no longer attempts to move to top left corner of element
* Remove deprecated support for sending Service parameters directly to Driver constructor
* Remove deprecated setters and getters for driver path on Browser modules
* Remove deprecated support for passing in options argument to Options class
* Allow `:options` parameter to take `Options` instance argument like other languages
* Remove deprecated support for `:desired_capabilities` & `:options` with `Hash` argument
4.2.1 (2022-05-31)
=========================
Ruby
* Fix bug in setting default duration in Actions constructor
4.2.0 (2022-05-27)
=========================
BiDi:
* Released selenium-devtools 0.97.0 (supports CDP v85, v95, v96, v97)
* Released selenium-devtools 0.98.0 (supports CDP v85, v96, v97, v98)
* Released selenium-devtools 0.99.0 (supports CDP v85, v97, v98, v99)
* Released selenium-devtools 0.100.0 (supports CDP v85, v98, v99, v100)
* Released selenium-devtools 0.101.0 (supports CDP v85, v99, v100, v101)
* Released selenium-devtools 0.102.0 (supports CDP v85, v100, v101, v102)
* Implement simple BiDi connection
* Fix bug in initial BiDi implementation (thanks Boris Petrov!)
* Fix bug with mutating headers in request interception (#10574)
* Fix bug with empty response headers (thanks Viren Negi!)
Firefox:
* Add support to Firefox Options for environment capability
* Use addon parameter instead of path parameter to avoid using file detector
* Restore #from_name method to Firefox profile (#10146)
Chromium:
* Add support for casting desktop
Ruby:
* Updated minimum required Ruby version to 2.7
* Fix bug by not attempting to stop service process when it's not started (#10015)
* Fix bug to not stop service process when it's not started (thanks Atsushi Tatsuma!)
* Use driver endpoint to get page source instead of JavaScript
* Add zenkaku_hankaku key support
* Fix download support of Selenium Server
* Do not convert Tag Name to CSS Selector
ActionBuilder:
* Raise error if input device not found
* Move `TypingInteraction` from `Interactions::KeyInput` to `Interactions` module
* Throw better errors for `PointerInput` methods
* Allow each action interaction class to validate its own source
* Set all Interactions classes to private
* Allow device names to use a default id if one is not specified
* Deprecate default mouse and keyboard values in constructor, favoring devices parameter
* Add support for pointer event properties
* Implement scroll wheel support
* Deprecate ordered pair parameters for pause method in favor of keywords
* Deprecate move to element with offset changing origin to top left of element
4.1.0 (2021-11-22)
=========================
DevTools:
* Released selenium-devtools 0.95.0 (supports CDP v85, v93, v94, v95)
* Released selenium-devtools 0.96.0 (supports CDP v85, v94, v95, v96)
* Added support for secure websockets (#10017)
Ruby:
* Execute Script supports ShadowRoots (#10019)
* Fixed bug preventing zipping temp files on Windows (#9987)
* Sang Pumpkin Carol (thanks Jari!)
4.0.3 (2021-10-20)
=========================
Firefox:
* Fixed bug avoiding camel casing prefs (#9944 thanks @glaszig)
Ruby:
* Fixed bug in Select class for finding by index (#9945)
Remote:
* Fixed bug preventing sending keys with an empty value
4.0.2 (2021-10-19)
=========================
Server:
* Fixed bug in new download code.
4.0.1 (2021-10-19)
=========================
Server:
* Fixed download by pointing to new storage location.
- Only supports Selenium 4 versions
* Added default value for Server::get and Server::download to use the latest server version
4.0.0 (2021-10-13)
=========================
Ruby:
* Updated minimum required Ruby version to 2.6
* Updated minimum required rexml gem version due to vulnerability
Chrome:
* Added default values for Network Conditions so no longer need to specify everything
Firefox:
* Fixed bug where Firefox prefs were converting snake case to camel case
4.0.0.rc3 (2021-10-08)
=========================
Ruby:
* Added support for getting timeout values from the driver
4.0.0.rc2 (2021-09-30)
=========================
DevTools:
* Released selenium-devtools 0.93.0 (2021-09-01)
- adds CDP version 93
- removes CDP version 91
* Released selenium-devtools 0.94.0 (2021-09-22)
- adds CDP version 94
- removes CDP version 92
* Added support for mutating responses in network interception
Ruby:
* Implemented Options#add_option to work for vendor extension capabilities
* Fixed bug for requiring uri (#9825 thanks @flanger001)
* Moved New Window functionality to TargetLocator#new_window to be used with Driver#switch_to
* Deprecated using Manager#new_window
* Changed order of logging output (#9850)
* Added support for web_socket_url capability
Chromium:
* Implemented casting functionality
* Implemented ability to launch chromium app
* Implemented support for specifying permissions
* Added support for Chrome-specific Android functionality with #enable_android
Firefox:
* Implemented context functionality
* Added support for Firefox-specific Android functionality with #enable_android
Remote:
* Added support for file detector to install Firefox addons from client machine
4.0.0.rc1 (2021-09-01)
=========================
DevTools:
* Released selenium-devtools 0.92.0 (2021-08-21) which:
- adds CDP versions 92
- removes CDP versions 88, 89, 90
IE:
* Added options for running Microsoft Edge in IE mode with IE Driver
Remote:
* Added default file detector for remote driver
Ruby:
* Fixed bug for getting valid capability that has not been set
* Fixed bug preventing loading of ServerError class
4.0.0.beta4 (2021-06-07)
=========================
Chrome:
* Fixed bug with camel casing of localState object
Firefox:
* Added support for Full Page Screenshots
Remote:
* Added support for #execute_cdp on Chrome and Edge
Ruby:
* Changed capabilities to use alwaysMatch instead of firstMatch by default
* Fixed bug preventing Options classes from handling Proxy instances
4.0.0.beta3 (2021-04-13)
=========================
Chrome:
* Fixed a regression with prefs hash keys being converted to camelCase.
* Fixed an issue when passing Profile object to Options would fail.
DevTools:
* Released selenium-devtools 0.91.0 which:
- adds CDP versions 90 and 91
- removes CDP versions 86 and 87
Remote:
* Added support for setting alwaysMatch/firstMatch capabilities per W3C
WebDriver specification. It's done using the following methods where
`caps` is either a Ruby hash with desired capabilities or an instance
of Remote::Capabilities:
* Selenium::WebDriver::Remote::Capabilities.always_match(caps)
* Selenium::WebDriver::Remote::Capabilities.first_match(caps)
* Added support for Driver#save_print_page.
* Fixed an issue with Driver#print_page.
* Added support for setting timeouts capabilities in Remote::Capabilities
per W3C WebDriver specification.
* Added support for Element#aria_role which returns WAI-ARIA role of the element.
* Added support for Element#accessible name which returns WAI-ARIA label of the element.
* Added support for using DevTools version provided by Grid instead of
calculating it manually
Ruby:
* Remove JRuby-specific socket poller. Note that this requires JRuby 9.2.8.0+.
4.0.0.beta2 (2021-03-16)
=========================
DevTools:
* Separated out DevTools methods into selenium-devtools gem to better manage versioning
* Updated supported versions to 85-89
* Add support for intercepting browser requests
Firefox:
* Add support for using DevTools commands with Firefox Nightly
Remote:
* Provide access to browser specific driver extensions as appropriate for designated browser
* Add support for using DevTools commands via Grid
Ruby:
* Spec Guard implementation moved into lib directory for other projects to use
* Implemented `Element#dom_attribute` to obtain attribute value as defined by w3c specification
* Implemented `Options#eq?`
* Allow Options subclass instances to be created from class methods in superclass
Safari:
* Fix bug that prevented usage of Safari Technology Preview
4.0.0.beta1 (2021-02-15)
=========================
DevTools:
* Updated supported versions to 85-88
Edge:
* Removed support for legacy Edge HTML
Firefox:
* Fixed support for default profile settings
* Added support for Devtools for Firefox v87+
Safari:
* Removed default platformName specification so it works with Grid
Ruby:
* Added support for httpOnly attribute in Cookies
* Implemented `#print_page` method (thanks @raju249)
* Fixed support for missing libraries in Ruby 3.0 (thanks @znz)
* Deprecated `HTTP::Persistent` class
* Fixed support for accessors in options classes
* Added support for status endpoint for all browsers
* Fix support for Browser, Driver, and Performance Logging in Chrome and Edge
4.0.0.alpha7 (2020-11-10)
=========================
Chrome:
* Fixed a link to download ChromeDriver when it's not found (thanks @masakazutakewaka).
* Fixed an issue when passing instance of Profile to an Options in capabilities
(thanks @masakazutakewaka).
DevTools:
* Added support for multiple version of CDP. Currently supported versions are
84-87. The proper version is automatically selected when the browser is started
based on its version. The implementation is Chromium-based and is confirmed
to work in Chrome and Edge at least.
* Added support for basic authentication (see HasAuthentication).
* Added support for listening to JavaScript console messages (see HasLogEvents).
* Added support for listening to JavaScript exceptions (see HasLogEvents).
* Added support for listening to DOM mutations (see HasLogEvents).
Edge:
* Switched default Edge implementation to Chromium-based. To use older versions
of Edge, pass :edge_html when initializing the driver.
Firefox:
* Fixed an issue whereby using the new capabilities structure in local drivers
would cause the W3C check to complain that `browser_name` was an invalid
capability key name (thanks @luke-hill)
Ruby:
* Added support for taking screenshots of individual elements using Element#screenshot
(thanks @johndouthat).
* Fixed deprecation message of using Net::HTTP::Proxy (thanks @masakazutakewaka).
* Fixed false negative detection of Linux on WSL2 (thanks @snsten).
* Support ChildProcess 4.x versions (thanks @boutil).
Safari:
* Fixed browser name in capabilities for Safari Technology Preview.
4.0.0.alpha6 (2020-05-28)
=========================
Chrome:
* Added DevTools classes and methods generated from the CDP specification.
It currently supports commands and events and provides Rubyish API:
driver.devtools.page.navigate(url: 'http://google.com')
driver.devtools.console.clear_messages
driver.devtools.page.enable
driver.devtools.page.on(:load_event_fired) do |params|
puts("Page loaded in #{params['timestamp']}")
end
Check https://chromedevtools.github.io/devtools-protocol/ for more information
about possible commands and events. Please note that this API is considered
to be experimental and may change any time before stable 4.0 release.
* Fixed an issue when passing :prompt_for_download (or similar snake_cased
symbols) in Options#prefs would be ignored by Chrome because Selenium
would internally convert it to camelCased format (:promptForDownload).
Now :prefs are left intact.
Edge:
* Fixed an issue when Driver#execute_cdp would not work for Chromium-based
Edge browser.
Ruby:
* Deprecated passing :desired_capabilities and :options to driver initialization
in favor of :capabilities. They now can be combined in an array to make
custom capabilities requirements:
caps = Selenium::WebDriver::Remote::Capabilities.chrome
opts = Selenium::WebDriver::Chrome::Options.new
Selenium::WebDriver.for(:remote, capabilities: :chrome)
Selenium::WebDriver.for(:remote, capabilities: caps)
Selenium::WebDriver.for(:remote, capabilities: opts)
Selenium::WebDriver.for(:remote, capabilities: [caps, opts])
* Deprecated passing Hash to :capabilities in favor of Remote::Capabilities object.
* Updated minimum require Ruby version to 2.5.
* Improved keyword arguments handling to avoid warnings in Ruby 2.7.
4.0.0.alpha5 (2020-03-18)
=========================
The release is just to synchronize version with other bindings and does not
include any changes.
4.0.0.alpha4 (2020-01-09)
=========================
Ruby:
* Added initial support for relative locators, which allow to find elements
above/below/left/right/near another element. For example, you can find all
the cells in a table to the right of your starting cell:
start_cell = driver.find_element(css: 'td')
right_cells = driver.find_elements(relative: {tag_name: 'td', right: start_cell})
The documentation is still lacking so refer to examples in df6be2e962.
* Added ability to silence certain logger messages by using it's identifiers:
Selenium::WebDriver.logger.ignore(:driver_path)
* Added new dependency: websocket. It's used for communicating with Chrome DevTools.
* Loosened childprocess dependency to allow using version 2.0+.
* Loosened rubyzip dependency to allow using version 2.0+.
* Fixed Errno::EACCES error on Linux DeX and similar distributes
Chrome:
* Added initial support for communicating with Chrome DevTools. The implementation
is very basic and lacks CDP domains, events and types - those will be added
in future releases. Still, it allows to execute simple commands to DevTools:
driver.devtools.send('Page.navigate', {url: 'https://google.com'})
4.0.0.alpha3 (2019-07-08)
=========================
Ruby:
* All documented driver capabilities supported in respective browser Options class by constructor and accessor
* Driver constructor :options and :desired_capabilities generate the same capabilities for local and remote execution
* Deprecated :options as keyword for initializing browser Options classes
Chrome:
* Add support for browser logging with latest versions of chromedriver
Edge:
* Add support for Chromium based implementation
4.0.0.alpha2 (2019-05-02)
=========================
Ruby:
* Fixed an issue with previous alpha release which lead to removed files
being packaged inside the gem
4.0.0.alpha1 (2019-05-01)
=========================
Ruby:
* Removed Mouse and Keyboard as their implementations are not compliant to WebDriver specification
* Removed TouchActionBuilder as its implementation is not compliant to WebDriver specification
* Change ActionBuilder to be fully compliant to WebDriver specification
* Change Manager to be fully compliant to WebDriver specification
* Removed all deprecated errors that are not compliant to WebDriver specification
* Update minimum required Ruby version to 2.4
* Changed capabilities to use only those that are compliant to WebDriver specification
* Removed deprecated timeout setter on default HTTP client
* Removed deprecated Remote::W3C::Capabilities
* Fixed an issue when services are not shutdown properly
Chrome:
* Removed support for OSS mode - use W3C mode instead by using
Selenium::WebDriver::Chrome::Options.new(options: {w3c: true})
PhantomJS:
* Removed support for PhantomJS driver
Firefox:
* Removed support for legacy Firefox driver - use GeckoDriver instead
* Removed deprecated outdated capabilities
* Fixed an issue when passing :profile string to Firefox::Options.new would
result in NoMethodError. Now it will find a profile with such name on your
system and use it accordingly (issue #7119)
3.142.7 (2019-12-27)
====================
Ruby:
* Fix keyword argument deprecations in Ruby 2.7 (thanks @connorshea)
3.142.6 (2019-10-04)
====================
Ruby:
* Loosen ChildProcess dependency so that 3.0+ can be used (thanks @jaredbeck)
3.142.5 (2019-10-01)
====================
Ruby:
* Loosen RubyZip dependency so that 1.3+ can be used (thanks @vtamara)
3.142.4 (2019-09-02)
====================
Chrome:
* Added support for new command for getting logs in ChromeDriver 76+
with W3C mode on
3.142.3 (2019-05-21)
====================
Firefox:
* Fixed a regression when Firefox binary path was not sent to GeckoDriver
by default and browser could not be located (issue #7219)
3.142.2 (2019-05-11)
====================
Chrome:
* Fixed an issue when getting/setting network conditions and sending CDP
commands didn't work with Grid (issue #7174)
Safari:
* Fixed an issue when getting/setting permissions and attaching debugger
didn't work with Grid (issue #7174)
3.142.1 (2019-05-07)
====================
Firefox:
* Fixed an issue when processing error in legacy driver would result
in NoMethodError (issue #7178)
3.142.0 (2019-04-24)
====================
Ruby:
* Fixed an issue when services are not shutdown properly
Firefox:
* Fixed an issue when passing :profile string to Firefox::Options.new would
result in NoMethodError. Now it will find a profile with such name on your
system and use it accordingly (issue #7119)
* Fixed an issue when instantiating Firefox driver with capabilities having
:marionette would result in NoMethodError (issue #7120)
3.141.5926 (2019-04-18)
=======================
Ruby:
* Fixed an issue when Selenium itself would print deprecation warning
for TimeoutError
* Fixed a regression when socket poller would raise Errno::EBADF on JRuby
3.141.592 (2019-04-18)
======================
Ruby:
* Updated minimum required Ruby version to 2.3
* Added support for ChildProcess 1.x
* Improved socket connection waiting (thanks @N0xFF)
* Changed waiting to use monotonic clock instead of Time class to avoid
collisions with Timecop and similar gems
* Removed deprecated PortProber.random
* Added strictFileInteractability to the list of known capabilities
* Added InsecureCertificateError
* Added support for setting SOCKS version in proxy (issue #6938)
* Implemented new window command using driver.manage.new_window. The command
is supported by recent Firefox, Safari and IE drivers (thanks @dylanlive)
* Added support for passing proc to driver_path setter in Service classes
* Deprecated all errors which don't exist in WebDriver specification
* Deprecated TouchActionBuilder which is not a part of WebDriver specification
and is only supported by Chrome, but is likely to be dropped in v75.
ActionBuilder should be used instead
* Deprecated using Remote::W3C::Capabilities in favor of Remote::Capabilities
Chrome:
* Added support for execute CDP commands using Driver#execute_cdp
* Removed GPU disabling in ChromeDriver when using Options#headless!
* Switched suggested download URL to HTTPS (thanks @JLLeitschuh)
* Added support for instantiating service class directly and moved all driver
executable configuration there (command-line arguments, port, etc.)
Passing driver_opts, driver_path and port to driver initializer is now
deprecated so use Selenium::WebDriver::Service.chrome instead, which allows
to customize executable behavior in similar way. Once initialized, this
object can be passed as :service keyword during driver initialization.
* Deprecated Chrome.driver_path= in favor of Service::Chrome.driver_path=
Edge:
* Added support for instantiating service class directly and moved all driver
executable configuration there (command-line arguments, port, etc.)
Passing driver_opts, driver_path and port to driver initializer is now
deprecated so use Selenium::WebDriver::Service.firefox instead, which allows
to customize executable behavior in similar way. Once initialized, this
object can be passed as :service keyword during driver initialization
* Deprecated Edge.driver_path= in favor of Service::Edge.driver_path=
Firefox:
* Deprecated legacy driver in favor of GeckoDriver
* Fixed Firefox path lookup on Cygwin (issue #6908)
* Added support for instantiating service class directly and moved all driver
executable configuration there (command-line arguments, port, etc.)
Passing driver_opts, driver_path and port to driver initializer is now
deprecated so use Selenium::WebDriver::Service.firefox instead, which allows
to customize executable behavior in similar way. Once initialized, this
object can be passed as :service keyword during driver initialization
* Deprecated Firefox.driver_path= in favor of Service::Firefox.driver_path=
* Deprecated outdated capabilities
IE:
* Fixed an issue when native events could not be disabled using IE::Options
initializer
* Added support for instantiating service class directly and moved all driver
executable configuration there (command-line arguments, port, etc.)
Passing driver_opts, driver_path and port to driver initializer is now
deprecated so use Selenium::WebDriver::Service.ie instead, which allows
to customize executable behavior in similar way. Once initialized, this
object can be passed as :service keyword during driver initialization
* Deprecated IE.driver_path= in favor of Service::IE.driver_path=
Safari:
* Added support for instantiating service class directly and moved all driver
executable configuration there (command-line arguments, port, etc.)
Passing driver_opts, driver_path and port to driver initializer is now
deprecated so use Selenium::WebDriver::Service.safari instead, which allows
to customize executable behavior in similar way. Once initialized, this
object can be passed as :service keyword during driver initialization
* Deprecated Safari.driver_path= in favor of Service::Safari.driver_path=
Remote:
* Change default HTTP client to use persistent connections
3.141.0 (2018-10-31)
====================
Edge:
* Added new Edge::Options class that should be used to customize browser
behavior. The instance of options class can be passed to driver
initialization using :options key. Please, note that using options require
insiders builds of Edge.
Chrome:
* Included HasLocation to Chrome driver (thanks @sidonath).
* Updated endpoint to send Chrome Debugging Protocol commands. The old one
has been deprecated in ChromeDriver 40.
Safari:
* Added new Safari::Options class that should be used to customize browser
behavior. The instance of options class can be passed to driver
initialization using :options key. Please, note that using options require
Safari 12+.
Remote:
* Allow passing Options instances to remote driver initialization using
:options key. This feature allows to use browser-specific options classes
(Chrome::Options, Firefox::Options, etc.) and pass them to Server/Grid
instead of capabilities.
3.14.1 (2018-10-03)
===================
Ruby:
* Added a workaround to ignore Errno::EALREADY error when starting drivers
on Windows Subsystem for Linux
* Changed default pause duration to 0 for Selenium::WebDriver::Driver#action#pause (thanks @twalpole)
* Deprecated Selenium::WebDriver::PortProber#random
in favor of Selenium::WebDriver::PortProber#above
* Fixed a bug when Selenium::WebDriver::Element#drag_and_drop would not
work in certain cases
* Updated RubyZip dependency to 1.2.2 which fixes security vulnerability
Edge:
* Added support for --silent driver flag
* Fixed an incorrect dash symbol when passing arguments to MicrosoftWebDriver.exe
Firefox:
* Fixed an incorrect dash symbol when passing arguments to GeckoDriver
Safari:
* Fixed a bug when Selenium::WebDriver::Element#displayed? would raise error
in Safari 12
3.14.0 (2018-08-03)
===================
Ruby:
* Allow to customize default duration of movement of pointer actions using
Driver#action#default_move_duration= (thanks @prakharrr)
* Fixed an accidentally removed Selenium::WebDriver::Error::TimeoutError (thanks @twalpole)
Server:
* Fixed an issue when Server.latest couldn't parse the version
Remote:
* Added support for uploading multiple files by passing them as a string
separated by \n to Element#send_keys. Please, note that not all the drivers
have multiple file upload implemented (tested to work in ChromeDriver).
3.13.1 (2018-07-20)
===================
Chrome:
* Fixed an issue when empty Chrome options would cause DevToolsActivePort issue (thanks @artplan1)
Remote:
* Support detecting local files (thanks @mskvn)
3.13.0 (2018-06-25)
===================
Ruby:
* Address warnings for redefined methods and uninitialized instance variables
Chrome:
* Chrome options capabilities updated to use goog:chromeOptions.
Note that Selenium now requires ChromeDriver v2.31 at minimum.
* Added ability to tell headless Chrome to save files using Driver#download_path= (thanks @pelly)
3.12.0 (2018-05-08)
===================
Ruby:
* Added User-Agent header to requests from Selenium to give remote
ends more visibility into distribution of clients (thanks @sah)
* Added Selenium::WebDriver::VERSION constant (thanks @sah)
* Added changelog link to RubyGems page
* Fixed a bug when requests were sent with empty Content-Type,
which should instead be application/json (issue #5615 and #5659)
* Fixed a bug when failed connection attempt was retried without
grace period for remote to resolve its problem (thanks @amckinley42)
* Fixed a bug with accidentally removed HasNetworkConnection driver extension
Chrome:
* Fixed a bug when deprecation message for using Chrome extensions
was incorrectly shown (thanks @treby)
Safari:
* Added support getting permissions via Driver#permissions
* Added support setting permissions via Driver#permissions=
* Added support enabling web inspector via Driver#attach_debugger
3.11.0 (2018-03-11)
===================
Ruby:
* No changes in Ruby bindings for this release
3.10.0 (2018-03-02)
===================
Ruby:
* Added Errno::EAFNOSUPPORT to the list of ignored errors when finding port (thanks @jtarchie)
* Added automatic conversion of noProxy to the list of strings as required
by W3C WebDriver Specification (issue #5004)
Chrome:
* Added Chrome::Options#headless! shortcut to enable headless mode (thanks @pulkitsharma07)
IE: