selenium-webdriver 2.53.4 → 3.8.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 040d77515f5ec4c62675327ab517eec003fbead5a3062766036e81bb9e44412b
+  data.tar.gz: d032a845a6bfa1819b0baddb61e93b2185d03623e4834fa55b1fa1090ea5829e
+SHA512:
+  metadata.gz: ea59ab603478f2713683e681a9d112673e6d0ce54bd7fab0711550cdee256527ddc9b7cc9c0bd1dae248f00274b73f4583365b28ede303f9961b4ffae737545e
+  data.tar.gz: 35c08a797df512637253014872e7262aa30ba676b2ee0fd4849175b074a8aaed4640c876ce1aa9da932a7e48ba7f085348b845551015aff4dde7611142f431d5

data/CHANGES

@@ -1,34 +1,387 @@
-2.53.4 (2016-06-14)
+3.8.0 (2017-12-01)
+==================
+
+Ruby:
+  * Removed deprecated Alert#authenticate
+  * Removed deprecated :port initialization argument of Remote::Bridge.
+    Use :url instead.
+  * Removed deprecated Selenium::WebDriver::Remote::W3CCapabilities.
+    Use Selenium::WebDriver::Remote::Capabilities instead.
+
+IE:
+  * Remove deprecated :log_file driver initialization argument.
+    Use driver_opts: {log_file: ''} instead.
+  * Remove deprecated :log_level driver initialization argument.
+    Use driver_opts: {log_level: ''} instead.
+  * Remove deprecated :implementation driver initialization argument.
+    Use driver_opts: {implementation: ''} instead.
+  * Removed deprecated :service_args driver initialization argument.
+    Use driver_opts: {args: ['--some-switch']} instead.
+
+Chrome:
+  * Removed deprecated :service_log_path driver initialization argument.
+    Use driver_opts: {log_path: 'path'} instead.
+  * Removed deprecated :service_args driver initialization argument.
+    Use driver_opts: {args: ['--some-switch']} instead.
+
+Firefox:
+  * Removed deprecated :service_args driver initialization argument.
+    Use driver_opts: {args: ['--some-switch']} instead.
+
+Safari:
+  * Removed deprecated :service_args driver initialization argument.
+    Use driver_opts: {args: ['--some-switch']} instead.
+
+Edge:
+  * Removed deprecated :service_args driver initialization argument.
+    Use driver_opts: {args: ['--some-switch']} instead.
+
+3.7.0 (2017-11-03)
+==================
+
+Ruby:
+  * Added //rb:lint task to check codebase using RuboCop (thanks @RustyNail)
+  * Fixed codebase to comply more to Ruby community style guide (thanks @RustyNail)
+  * Packaged all dependencies to Selenium repository so that non-Ruby committers
+    can build and test Ruby bindings easier
+  * Update errors list according to latest changes of specification (thanks @jaysonesmith)
+
+Firefox:
+  * Added Firefox::Options#headless! shortcut to enable headless mode (thanks @franzliedke)
+
+3.6.0 (2017-09-25)
+==================
+
+Edge:
+  * Fixed a bug when execute_script failed using server + Edge (issue #4651)
+
+Firefox:
+  * Fixed a bug when web extension failed to install using profile class (issue #4093)
+
+PhantomJS:
+  * Support is deprecated in favor of headless Chrome/Firefox or HTMLUnit.
+    PhantomJS is no longer actively developed, and support will eventually
+    be dropped.
+
+3.5.2 (2017-09-07)
+==================
+
+Ruby:
+  * Removed platformVersion from W3C payload (issue #4641)
+  * Fixed a bug when proxy type was not compliant to specification (issue #4574)
+  * Added support for passing speed to flick action (issue #4549)
+  * Using TouchActionBuilder no longer prints mouse/key deprecations
+  * Deprecated Alert#authenticate
+  * Added support for DEBUG environment variable which enables full debug mode in gem
+
+Firefox:
+  * Fixed a bug when page load timeout was not properly constructed in new session payload
+  * Fixed a bug when GeckoDriver error stacktrace was not displayed (issue #3683)
+
+Chrome:
+  * Added workaround for the case when findElements call returns null (issue #4555)
+  * Chrome::Driver now includes touch actions by default
+
+3.5.1 (2017-08-15)
+==================
+
+Ruby:
+  * Fixed a bug when Chrome/Firefox (and probably other) drivers could not be
+    started on JRuby (issue #4453).
+
+3.5.0 (2017-08-10)
+==================
+
+Firefox:
+  * Firefox subprocess output is now only redirected when debug is set (issue #4311)
+  * Fixed a bug where non-integers could be sent when setting window rect
+  * Fixed Firefox location detection on Windows_x64 (thanks kamenlitchev)
+  * Fixed passing of profile with a W3C compatible remote end
+
+IE:
+  * Added new IE::Options class that should be used to customize browser
+    behavior (native events, element scroll behavior, etc).
+    The instance of options class can be passed to driver initialization using
+    :options key. Old way of passing these customization directly to driver
+    initialization is deprecated.
+
+3.4.4 (2017-07-13)
+==================
+
+Firefox:
+  * Added support for GeckoDriver install addon command (issue 4215).
+  * Added support for GeckoDriver uninstall addon command (issue 4215).
+  * Raise error when passing :firefox_options as capability.
+
+Ruby:
+  * Fixed a bug when childprocess were leaking /dev/null file descriptor (issue 4285).
+  * Make Remote::Driver class so that it can be inherited from.
+
+3.4.3 (2017-06-16)
+==================
+
+Ruby:
+  * Fixed a regression when passing symbol as :desired_capabilities caused NoMethodError (issue 4187).
+
+3.4.2 (2017-06-14)
+==================
+
+Ruby:
+  * Added unhandledPromptBehavior to the list of known capabilities.
+  * Added timeouts to the list of known capabilities.
+  * Fixed a regression when passing hash as :desired_capabilities caused NoMethodError (issue 4172, thanks Thomas Walpole).
+  * Fixed a regression when extension capabilities (the ones that have ":" inside)
+    were filtered out when doing protocol handshake.
+  * Improved handling of capability names passed as plain camelCased strings
+    vs Rubyish snake_cased symbols when doing protocol handshake.
+
+Chrome:
+  * Fixed a regression when passing :switches to driver initialization was ignored.
+
+3.4.1 (2017-06-13)
+==================
+
+Ruby:
+  * Implemented a new dual-dialect mechanism for communication with drivers
+    (a.k.a. protocol handshake). There shouldn't be any noticeable differences
+    but since this is a significant refactoring of internal APIs, some bugs
+    could slip into the release.
+  * Renamed ElementClickIntercepted to ElementClickInterceptedError.
+  * Renamed ElementNotInteractable to ElementNotInteractableError.
+  * Deprecated W3CCapabilities in favor of Capabilities (it was meant to be private API).
+  * Added a warning when trying to save screenshot without .png extension (thanks @abotalov).
+
+IE:
+  * Added support for both old IEDriver which uses OSS dialect of JSON wire
+    protocol (<= 3.4.0) and new IEDriver which uses W3C dialect (not yet released).
+
+Safari:
+  * Removed runtime dependencies used for old SafariDriver (u.g. websocket).
+
+Chrome:
+  * Added new Chrome::Options class that should be used to customize browser
+    behavior (command line arguments, extensions, preferences, mobile emulation, etc.).
+    The instance of options class can be passed to driver initialization using
+    :options key. Old way of passing these customization directly to driver
+    initialization is deprecated.
+
+Firefox:
+  * Added new Firefox::Options class that should be used to customize browser
+    behavior (command line arguments, profile, preferences, Firefox binary, etc.).
+    The instance of options class can be passed to driver initialization using
+    :options key. Old way of passing these customization directly to driver
+    initialization is deprecated.
+
+3.4.0 (2017-04-21)
 ===================
 
+Edge:
+  * Fix bug when response is not wrapped with "value"
+
 Firefox:
-  * FirefoxDriver works with v47.0.1 (issue 2110)
+  * Support geckodriver v0.16
+
+Ruby:
+  * Support ElementClickIntercepted error from W3C spec
+  * Support ElementNotInteractable error from W3C spec
+  * Implement window rect commands
+  * Implement window minimize command
 
-2.53.3 (2016-06-14)
+3.3.0 (2017-03-07)
 ===================
 
 Firefox:
-  * Fix bug with Firefox Binary & Marionette on Remote machines (issue 2281)
+  * geckodriver v0.15 or later is required
+
+W3C:
+  * Support for command response data to be wrapped in a 'value' key
+  * Support for updated timeout formats
+
+3.2.2 (2017-03-01)
+===================
+
+Ruby:
+  * Fix bug for supporting Logger output on Ruby versions < 2.3
+  * Add more logging and adjust output levels
+
+Remote:
+  * Support for creating Remote session with browser name and url parameters
 
-2.53.2 (2016-06-13)
+3.2.1 (2017-02-24)
 ===================
 
 Ruby:
-  * Fix bug for finding binaries on Windows (issue 2271 & 2273)
+  * Fix bug for supporting Logger on Ruby versions < 2.3
 
-2.53.1 (2016-06-09)
+3.2.0 (2017-02-22)
+===================
+
+Ruby:
+  * Implement new Logger class
+  * Fix issue with chromedriver process leader incompatibility on Win7 (issue 3512)
+
+3.1.0 (2017-02-14)
+===================
+
+Firefox:
+  * implement W3C actions endpoint
+
+3.0.8 (2017-02-08)
+===================
+
+Firefox:
+  * Fix signature of element returned from #active_element
+
+3.0.7 (2017-02-06)
+===================
+
+Firefox:
+  * Fix signature of element arrays returned from #find_elements (issue 3471)
+
+3.0.6 (2017-02-05)
+===================
+
+Firefox:
+  * Implement W3C window position
+  * Update implementation for W3C send text to alert
+  * Implement timeout settings
+  * Remove default capabilities (thanks lmtierney)
+  * Fix signature of elements returned from #execute_script (thanks Thomas Walpole)
+
+3.0.5 (2016-12-27)
+===================
+
+Ruby:
+  * Support for Ruby 2.4.0 (Thanks jamespdo)
+
+3.0.4 (2016-12-21)
+===================
+
+Firefox:
+  * Implement profile support via geckodriver (#2933 thanks lmtierney)
+
+Ruby:
+  * Fix bug preventing use of Curb client (#2951 thanks clarkenciel)
+  * Support Net::HTTP::Persistent version 3 (#3219 thanks Pete Johns)
+  * Allow Net::HTTP::Default to set open_timout and read_timeout independently (#3264 thanks richseviora)
+  * Change default for Net::HTTP::Default#open_timeout to facilitate debuggers  (#3264 thanks richseviora)
+
+3.0.3 (2016-11-26)
+===================
+
+Ruby:
+  * Allow drivers to be executed from batch files on Windows
+
+3.0.2 (2016-11-25)
+===================
+
+Ruby:
+  * Implement #driver_path as parameter when initializing a driver (thanks lmtierney)
+  * Improve Ruby syntax in driver commands (thanks joe_schulte)
+  * Improve performance when shutting down drivers (thanks lmtierney)
+  * Fix bug for finding open ports on Windows (thanks kou1okada)
+  * Fix bug in auto detection of drivers which allowed selection of non-executable binaries
+
+W3C:
+  * Implement #cookie_named and #delete_all_cookies methods (thanks lmtierney)

+  * Implement element #property method (thanks lmtierney)

+
+Chrome:
+  * Fix bug in switches (thanks danvine)

+
+3.0.1 (2016-11-06)
+===================
+
+Ruby:
+  * Always send JSON Wire Protocol commands to server instead of W3C commands
+
+3.0.0 (2016-10-13)
+===================
+
+Firefox:
+  * Update :firefox_options support for geckodriver 0.11
+
+3.0.0.beta4 (2016-09-29)
+===================
+
+Ruby:
+  * Remove support for deprecated driver options
+  * Add support for latest driver options
+  * Add support for :port parameter for launching driver
+  * Add support for :service_args parameter for driver command line switches
+  * Improve reliability by increasing service shutdown timeout (#2815; thanks John Barbuto )

+
+Firefox:
+  * Add support for :firefox_options in geckodriver
+
+Safari:
+  * Remove support for legacy Safari driver (use Apple's driver built in to Safari 10+)
+
+Chrome:
+  * Set chromedriver to not log by default
+
+3.0.0.beta3.1 (2016-09-03)
+===================
+
+Firefox:
+  * Fixed bug - legacy firefox extension included in gem
+
+3.0.0.beta3 (2016-09-01)
 ===================
 
 Firefox:
-  * Support for latest geckodriver (formerly wires)
-  * Escape selector when converting to CSS (issue 2235)
+  * Implemented w3c getAttribute with javascript atom
 
-2.53.0 (2016-03-16)
+3.0.0.beta2.1 (2016-08-03)
+===================
+
+Ruby:
+  * Fixed bug in collections
+
+3.0.0.beta2 (2016-08-02)
+===================
+
+Firefox:
+  * Fixed bug with form submission
+  * Improved w3c element handling
+
+3.0.0.beta1 (2016-07-28)
+===================
+
+Ruby:
+  * Remove support for RC client
+  * Remove support for Ruby < 2.0
+  * Update code to support designated style guidelines
+  * Chrome/GeckoDriver/PhantomJS/IE/Edge drivers are refactored to use standard
+    service class (issue 1797)
+  * Option `:timeout` was removed from IE server (issue 1797)
+
+Chrome:
+  * Remove override of default chromedriver behavior for chrome.detach (issue 2418)
+
+Firefox:
+  * Rename wires to geckodriver
+  * Change default usage from FirefoxDriver to geckodriver
+
+Safari:
+  * Initial support for Apple's Safari Driver in Sierra (issue #2475)
+
+Android and iPhone:
+  * Remove support for deprecated classes (Issue #2476)
+
+2.53.0 (2016-03-15)
 ===================
 
 Ruby:
   * Removed dependency on "multi_json" (issue 1632)
   * Properly handle namespaces in install manifest of Firefox add-ons (issue 1143)
+  * Improve error handling when stopping browsers (thanks bsedat)
+  * Fix deselecting options in select lists (thanks glib-briia)
+  * Fix w3c error handling
+  * Update w3c Capabilities support
+
+IE:
+  * support for alert credentials (issue #1698, thanks Alan Baird & trabulmonkee)
 
 2.52.0 (2016-02-12)
 ===================

data/LICENSE

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2016 Software Freedom Conservancy (SFC)
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

data/README.md

@@ -1,8 +1,7 @@
 # selenium-webdriver
 
 This gem provides Ruby bindings for WebDriver
-and has been tested to work on MRI (1.9.2 through 2.1),
-JRuby and Rubinius.
+and has been tested to work on MRI (2.0 through 2.2),
 
 ## Install
 
@@ -17,7 +16,7 @@ JRuby and Rubinius.
 
 ## License
 
-Copyright 2009-2015 Software Freedom Conservancy
+Copyright 2009-2017 Software Freedom Conservancy
 
 Licensed to the Software Freedom Conservancy (SFC) under one
 or more contributor license agreements.  See the NOTICE file

data/lib/selenium-webdriver.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-#
 # 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

data/lib/selenium/server.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-#
 # 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
@@ -22,7 +20,6 @@ require 'selenium/webdriver/common/socket_poller'
 require 'net/http'
 
 module Selenium
-
   #
   # Wraps the remote server jar
   #
@@ -66,59 +63,72 @@ module Selenium
     # Download the given version of the selenium-server-standalone jar.
     #
 
-    def self.download(required_version)
-      required_version = latest if required_version == :latest
-      download_file_name = "selenium-server-standalone-#{required_version}.jar"
+    class << self
+      def download(required_version)
+        required_version = latest if required_version == :latest
+        download_file_name = "selenium-server-standalone-#{required_version}.jar"
 
-      if File.exists? download_file_name
-        return download_file_name
-      end
+        return download_file_name if File.exist? download_file_name
 
-      begin
-        open(download_file_name, "wb") do |destination|
-          net_http.start("selenium-release.storage.googleapis.com") do |http|
-            resp = http.request_get("/#{required_version[/(\d+\.\d+)\./, 1]}/#{download_file_name}") do |response|
-              total = response.content_length
-              progress = 0
-              segment_count = 0
-
-              response.read_body do |segment|
-                progress += segment.length
-                segment_count += 1
-
-                if segment_count % 15 == 0
-                  percent = (progress.to_f / total.to_f) * 100
-                  print "#{CL_RESET}Downloading #{download_file_name}: #{percent.to_i}% (#{progress} / #{total})"
-                  segment_count = 0
-                end
+        begin
+          open(download_file_name, 'wb') do |destination|
+            net_http.start('selenium-release.storage.googleapis.com') do |http|
+              resp = http.request_get("/#{required_version[/(\d+\.\d+)\./, 1]}/#{download_file_name}") do |response|
+                total = response.content_length
+                progress = 0
+                segment_count = 0
+
+                response.read_body do |segment|
+                  progress += segment.length
+                  segment_count += 1
 
-                destination.write(segment)
+                  if (segment_count % 15).zero?
+                    percent = (progress.to_f / total.to_f) * 100
+                    print "#{CL_RESET}Downloading #{download_file_name}: #{percent.to_i}% (#{progress} / #{total})"
+                    segment_count = 0
+                  end
+
+                  destination.write(segment)
+                end
               end
-            end
 
-            unless resp.kind_of? Net::HTTPSuccess
-              raise Error, "#{resp.code} for #{download_file_name}"
+              unless resp.is_a? Net::HTTPSuccess
+                raise Error, "#{resp.code} for #{download_file_name}"
+              end
             end
           end
+        rescue
+          FileUtils.rm download_file_name if File.exist? download_file_name
+          raise
         end
-      rescue
-        FileUtils.rm download_file_name if File.exists? download_file_name
-        raise
+
+        download_file_name
       end
 
-      download_file_name
-    end
+      #
+      # Ask Google Code what the latest selenium-server-standalone version is.
+      #
 
-    #
-    # Ask Google Code what the latest selenium-server-standalone version is.
-    #
+      def latest
+        require 'rexml/document'
+        net_http.start('selenium-release.storage.googleapis.com') do |http|
+          REXML::Document.new(http.get('/').body).root.get_elements('//Contents/Key').map do |e|
+            e.text[/selenium-server-standalone-(\d+\.\d+\.\d+)\.jar/, 1]
+          end.compact.max
+        end
+      end
+
+      def net_http
+        http_proxy = ENV['http_proxy'] || ENV['HTTP_PROXY']
 
-    def self.latest
-      require 'rexml/document'
-      net_http.start("selenium-release.storage.googleapis.com") do |http|
-        REXML::Document.new(http.get("/").body).root.get_elements("//Contents/Key").map { |e|
-          e.text[/selenium-server-standalone-(\d+\.\d+\.\d+)\.jar/, 1]
-        }.compact.max
+        if http_proxy
+          http_proxy = "http://#{http_proxy}" unless http_proxy.start_with?('http://')
+          uri = URI.parse(http_proxy)
+
+          Net::HTTP::Proxy(uri.host, uri.port)
+        else
+          Net::HTTP
+        end
       end
     end
 
@@ -162,7 +172,7 @@ module Selenium
       raise Errno::ENOENT, jar unless File.exist?(jar)
 
       @jar        = jar
-      @host       = "127.0.0.1"
+      @host       = '127.0.0.1'
       @port       = opts.fetch(:port, 4444)
       @timeout    = opts.fetch(:timeout, 30)
       @background = opts.fetch(:background, false)
@@ -180,7 +190,7 @@ module Selenium
 
     def stop
       begin
-        Net::HTTP.get(@host, "/selenium-server/driver/?cmd=shutDownSeleniumServer", @port)
+        Net::HTTP.get(@host, '/selenium-server/driver/?cmd=shutDownSeleniumServer', @port)
       rescue Errno::ECONNREFUSED
       end
 
@@ -195,7 +205,7 @@ module Selenium
     end
 
     def <<(arg)
-      if arg.kind_of?(Array)
+      if arg.is_a?(Array)
         @additional_args += arg
       else
         @additional_args << arg.to_s
@@ -204,19 +214,6 @@ module Selenium
 
     private
 
-    def self.net_http
-      http_proxy = ENV['http_proxy'] || ENV['HTTP_PROXY']
-
-      if http_proxy
-        http_proxy = "http://#{http_proxy}" unless http_proxy.start_with?("http://")
-        uri = URI.parse(http_proxy)
-
-        Net::HTTP::Proxy(uri.host, uri.port)
-      else
-        Net::HTTP
-      end
-    end
-
     def stop_process
       return unless @process.alive?
 
@@ -233,11 +230,16 @@ module Selenium
 
     def process
       @process ||= (
-        cp = ChildProcess.build("java", "-jar", @jar, "-port", @port.to_s, *@additional_args)
+        # extract any additional_args that start with -D as options
+        properties = @additional_args.dup - @additional_args.delete_if { |arg| arg[/^-D/] }
+        server_command = ['java'] + properties + ['-jar', @jar, '-port', @port.to_s] + @additional_args
+        cp = ChildProcess.build(*server_command)
+        WebDriver.logger.debug("Executing Process #{server_command}")
+
         io = cp.io
 
-        if @log.kind_of?(String)
-          @log_file = File.open(@log, "w")
+        if @log.is_a?(String)
+          @log_file = File.open(@log, 'w')
           io.stdout = io.stderr = @log_file
         elsif @log
           io.inherit!
@@ -250,20 +252,17 @@ module Selenium
     end
 
     def poll_for_service
-      unless socket.connected?
-        raise Error, "remote server not launched in #{@timeout} seconds"
-      end
+      return if socket.connected?
+      raise Error, "remote server not launched in #{@timeout} seconds"
     end
 
     def poll_for_shutdown
-      unless socket.closed?
-        raise Error, "remote server not stopped in #{@timeout} seconds"
-      end
+      return if socket.closed?
+      raise Error, "remote server not stopped in #{@timeout} seconds"
     end
 
     def socket
       @socket ||= WebDriver::SocketPoller.new(@host, @port, @timeout)
     end
-
   end # Server
 end # Selenium