selenium-webdriver 2.45.0 → 3.142.7

data/lib/selenium/webdriver/edge/bridge.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Edge
+      module Bridge
+
+        def commands(command)
+          unsupported = %i[execute_script execute_async_script submit_element double_click
+                           mouse_down mouse_up mouse_move_to click
+                           send_keys_to_active_element get_window_handles get_current_window_handle
+                           get_window_size set_window_size get_window_position set_window_position
+                           maximize_window get_alert_text accept_alert dismiss_alert]
+          if unsupported.include? command
+            Remote::OSS::Bridge::COMMANDS[command]
+          else
+            super
+          end
+        end
+
+        def send_keys_to_active_element(key)
+          execute :send_keys_to_active_element, {}, {value: key}
+        end
+
+        def window_handle
+          execute :get_current_window_handle
+        end
+
+        def window_size(handle = :current)
+          data = execute :get_window_size, window_handle: handle
+
+          Dimension.new data['width'], data['height']
+        end
+
+        def resize_window(width, height, handle = :current)
+          execute :set_window_size, {window_handle: handle},
+                  {width: width,
+                   height: height}
+        end
+
+        def window_position(handle = :current)
+          data = execute :get_window_position, window_handle: handle
+
+          Point.new data['x'], data['y']
+        end
+
+        def reposition_window(x, y, handle = :current)
+          execute :set_window_position, {window_handle: handle},
+                  {x: x, y: y}
+        end
+
+        def maximize_window(handle = :current)
+          execute :maximize_window, window_handle: handle
+        end
+
+      end # Bridge
+    end # Edge
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/edge/driver.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Edge
+
+      #
+      # Driver implementation for Microsoft Edge.
+      # @api private
+      #
+
+      class Driver < WebDriver::Driver
+        include DriverExtensions::TakesScreenshot
+
+        def initialize(opts = {})
+          opts[:desired_capabilities] ||= Remote::Capabilities.edge
+
+          opts[:url] ||= service_url(opts)
+
+          listener = opts.delete(:listener)
+
+          # Edge is mostly using W3C dialect, but a request to
+          # create session responds with OSS-like body,
+          # so we need to force W3C implementation.
+          desired_capabilities = opts.delete(:desired_capabilities)
+          bridge = Remote::Bridge.new(opts)
+          capabilities = bridge.create_session(desired_capabilities)
+
+          WebDriver.logger.info 'Forcing W3C dialect.'
+          @bridge = Remote::W3C::Bridge.new(capabilities, bridge.session_id, **opts)
+          @bridge.extend Edge::Bridge
+
+          super(@bridge, listener: listener)
+        end
+
+        def browser
+          :edge
+        end
+
+        def quit
+          super
+        ensure
+          @service&.stop
+        end
+
+      end # Driver
+    end # Edge
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/edge/options.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Edge
+      class Options
+        attr_accessor :in_private, :start_page
+        attr_reader :extension_paths
+
+        #
+        # Create a new Options instance for Edge.
+        #
+        # @example
+        #   options = Selenium::WebDriver::Edge::Options.new(in_private: true)
+        #   driver = Selenium::WebDriver.for :edge, options: options
+        #
+        # @param [Hash] opts the pre-defined options to create the Edge::Options with
+        # @option opts [Boolean] :in_private Start in private mode. Default is false
+        # @option opts [Array<String>] :extension_paths A list of full paths to extensions to install on startup
+        # @option opts [String] :start_page Default page to start with
+        #
+        # @see https://docs.microsoft.com/en-us/microsoft-edge/webdriver
+        #
+
+        def initialize(**opts)
+          @in_private = opts.delete(:in_private) || false
+          @extension_paths = opts.delete(:extension_paths) || []
+          @start_page = opts.delete(:start_page)
+        end
+
+        #
+        # Add an extension by local path.
+        #
+        # @example
+        #   options = Selenium::WebDriver::Edge::Options.new
+        #   options.add_extension_path('C:\path\to\extension')
+        #
+        # @param [String] path The local path to the extension folder
+        #
+
+        def add_extension_path(path)
+          raise Error::WebDriverError, "could not find extension at #{path.inspect}" unless File.directory?(path)
+
+          @extension_paths << path
+        end
+
+        #
+        # @api private
+        #
+
+        def as_json(*)
+          opts = {}
+
+          opts['ms:inPrivate'] = true if @in_private
+          opts['ms:extensionPaths'] = @extension_paths if @extension_paths.any?
+          opts['ms:startPage'] = @start_page if @start_page
+
+          opts
+        end
+      end # Options
+    end # Edge
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/edge/service.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Edge
+      #
+      # @api private
+      #
+
+      class Service < WebDriver::Service
+        @default_port = 17556
+        @executable = 'MicrosoftWebDriver'
+        @missing_text = <<~ERROR
+          Unable to find MicrosoftWebDriver. Please download the server from
+          https://www.microsoft.com/en-us/download/details.aspx?id=48212 and place it somewhere on your PATH.
+          More info at https://github.com/SeleniumHQ/selenium/wiki/MicrosoftWebDriver.
+        ERROR
+        @shutdown_supported = true
+
+        private
+
+        # Note: This processing is deprecated
+        def extract_service_args(driver_opts)
+          driver_args = super
+          driver_opts = driver_opts.dup
+          driver_args << "--host=#{driver_opts[:host]}" if driver_opts.key? :host
+          driver_args << "--package=#{driver_opts[:package]}" if driver_opts.key? :package
+          driver_args << "--silent" if driver_opts[:silent] == true
+          driver_args << "--verbose" if driver_opts[:verbose] == true
+          driver_args
+        end
+      end # Service
+    end # Edge
+  end # WebDriver
+end # Service

data/lib/selenium/webdriver/edge.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+require 'net/http'
+
+require 'selenium/webdriver/edge/bridge'
+require 'selenium/webdriver/edge/driver'
+require 'selenium/webdriver/edge/options'
+
+module Selenium
+  module WebDriver
+    module Edge
+      def self.driver_path=(path)
+        WebDriver.logger.deprecate 'Selenium::WebDriver::Edge#driver_path=',
+                                   'Selenium::WebDriver::Edge::Service#driver_path='
+        Selenium::WebDriver::Edge::Service.driver_path = path
+      end
+
+      def self.driver_path
+        WebDriver.logger.deprecate 'Selenium::WebDriver::Edge#driver_path',
+                                   'Selenium::WebDriver::Edge::Service#driver_path'
+        Selenium::WebDriver::Edge::Service.driver_path
+      end
+    end # Edge
+  end # WebDriver
+end # Selenium
+
+require 'selenium/webdriver/edge/service'

data/lib/selenium/webdriver/firefox/binary.rb

@@ -1,42 +1,59 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
 module Selenium
   module WebDriver
     module Firefox
-
       # @api private
       class Binary
-
-        NO_FOCUS_LIBRARY_NAME = "x_ignore_nofocus.so"
-        NO_FOCUS_LIBRARIES    = [
-          ["#{WebDriver.root}/selenium/webdriver/firefox/native/linux/amd64/#{NO_FOCUS_LIBRARY_NAME}", "amd64/#{NO_FOCUS_LIBRARY_NAME}"],
-          ["#{WebDriver.root}/selenium/webdriver/firefox/native/linux/x86/#{NO_FOCUS_LIBRARY_NAME}", "x86/#{NO_FOCUS_LIBRARY_NAME}"],
-        ]
+        NO_FOCUS_LIBRARY_NAME = 'x_ignore_nofocus.so'
+        NO_FOCUS_LIBRARIES = [
+          ["#{WebDriver.root}/selenium/webdriver/firefox/native/linux/amd64/#{NO_FOCUS_LIBRARY_NAME}",
+           "amd64/#{NO_FOCUS_LIBRARY_NAME}"],
+          ["#{WebDriver.root}/selenium/webdriver/firefox/native/linux/x86/#{NO_FOCUS_LIBRARY_NAME}",
+           "x86/#{NO_FOCUS_LIBRARY_NAME}"]
+        ].freeze
 
         WAIT_TIMEOUT = 90
         QUIT_TIMEOUT = 5
 
         def start_with(profile, profile_path, *args)
           if Platform.cygwin?
-            profile_path = Platform.cygwin_path(profile_path, :windows => true)
+            profile_path = Platform.cygwin_path(profile_path, windows: true)
           elsif Platform.windows?
-            profile_path = profile_path.gsub("/", "\\")
+            profile_path = Platform.windows_path(profile_path)
           end
 
-          ENV['XRE_CONSOLE_LOG']           = profile.log_file if profile.log_file
-          ENV['XRE_PROFILE_PATH']          = profile_path
-          ENV['MOZ_NO_REMOTE']             = '1' # able to launch multiple instances
+          ENV['XRE_CONSOLE_LOG'] = profile.log_file if profile.log_file
+          ENV['XRE_PROFILE_PATH'] = profile_path
+          ENV['MOZ_NO_REMOTE'] = '1' # able to launch multiple instances
           ENV['MOZ_CRASHREPORTER_DISABLE'] = '1' # disable breakpad
-          ENV['NO_EM_RESTART']             = '1' # prevent the binary from detaching from the console
+          ENV['NO_EM_RESTART'] = '1' # prevent the binary from detaching from the console
 
-          if Platform.linux? && (profile.native_events? || profile.load_no_focus_lib?)
-            modify_link_library_path profile_path
-          end
+          modify_link_library_path profile_path if Platform.linux? && (profile.native_events? || profile.load_no_focus_lib?)
 
           execute(*args)
-          cope_with_mac_strangeness(args) if Platform.mac?
         end
 
         def quit
           return unless @process
+
           @process.poll_for_exit QUIT_TIMEOUT
         rescue ChildProcess::TimeoutError
           # ok, force quit
@@ -57,26 +74,12 @@ module Selenium
         private
 
         def execute(*extra_args)
-          args = [self.class.path, "-no-remote"] + extra_args
+          args = [self.class.path, '-no-remote'] + extra_args
           @process = ChildProcess.build(*args)
-          @process.io.inherit! if $DEBUG
-          @process.start
-        end
-
-        def cope_with_mac_strangeness(args)
-          sleep 0.3
-
-          if @process.crashed?
-            # ok, trying a restart
-            sleep 7
-            execute(*args)
-          end
+          WebDriver.logger.debug("Executing Process #{args}")
 
-          # ensure we're ok
-          sleep 0.3
-          if @process.crashed?
-            raise Error::WebDriverError, "unable to start Firefox cleanly, args: #{args.inspect}"
-          end
+          @process.io.stdout = @process.io.stderr = WebDriver.logger.io if WebDriver.logger.debug?
+          @process.start
         end
 
         def modify_link_library_path(profile_path)
@@ -93,11 +96,10 @@ module Selenium
           paths += ENV['LD_LIBRARY_PATH'].to_s.split(File::PATH_SEPARATOR)
 
           ENV['LD_LIBRARY_PATH'] = paths.uniq.join(File::PATH_SEPARATOR)
-          ENV['LD_PRELOAD']      = NO_FOCUS_LIBRARY_NAME
+          ENV['LD_PRELOAD'] = NO_FOCUS_LIBRARY_NAME
         end
 
         class << self
-
           #
           # @api private
           #
@@ -109,6 +111,10 @@ module Selenium
             @path = path
           end
 
+          def reset_path!
+            @path = nil
+          end
+
           def path
             @path ||= case Platform.os
                       when :macosx
@@ -116,29 +122,47 @@ module Selenium
                       when :windows
                         windows_path
                       when :linux, :unix
-                        Platform.find_binary("firefox3", "firefox2", "firefox") || "/usr/bin/firefox"
+                        Platform.find_binary('firefox3', 'firefox2', 'firefox') || '/usr/bin/firefox'
                       else
                         raise Error::WebDriverError, "unknown platform: #{Platform.os}"
                       end
 
-            @path = Platform.cygwin_path(@path) if Platform.cygwin?
+            @path = Platform.cygwin_path(@path, windows: true) if Platform.cygwin?
 
             unless File.file?(@path.to_s)
-              raise Error::WebDriverError, "Could not find Firefox binary (os=#{Platform.os}). Make sure Firefox is installed or set the path manually with #{self}.path="
+              error = "Could not find Firefox binary (os=#{Platform.os}). " \
+                      "Make sure Firefox is installed or set the path manually with #{self}.path="
+              raise Error::WebDriverError, error
             end
 
             @path
           end
 
+          def version
+            @version = case Platform.os
+                       when :macosx
+                         `#{path} -v`.strip[/[^\s]*$/][/^\d+/].to_i
+                       when :windows
+                         `\"#{path}\" -v | more`.strip[/[^\s]*$/][/^\d+/].to_i
+                       when :linux
+                         `#{path} -v`.strip[/[^\s]*$/][/^\d+/].to_i
+                       else
+                         0
+                       end
+          end
+
           private
 
           def windows_path
-            windows_registry_path || Platform.find_in_program_files("\\Mozilla Firefox\\firefox.exe") || Platform.find_binary("firefox")
+            windows_registry_path ||
+              Platform.find_in_program_files('\\Mozilla Firefox\\firefox.exe') ||
+              Platform.find_binary('firefox')
           end
 
           def macosx_path
-            path = "/Applications/Firefox.app/Contents/MacOS/firefox-bin"
-            path = Platform.find_binary("firefox-bin") unless File.exist?(path)
+            path = '/Applications/Firefox.app/Contents/MacOS/firefox-bin'
+            path = File.expand_path('~/Applications/Firefox.app/Contents/MacOS/firefox-bin') unless File.exist?(path)
+            path = Platform.find_binary('firefox-bin') unless File.exist?(path)
 
             path
           end
@@ -147,18 +171,16 @@ module Selenium
             require 'win32/registry'
 
             lm = Win32::Registry::HKEY_LOCAL_MACHINE
-            lm.open("SOFTWARE\\Mozilla\\Mozilla Firefox") do |reg|
+            lm.open('SOFTWARE\\Mozilla\\Mozilla Firefox') do |reg|
               main = lm.open("SOFTWARE\\Mozilla\\Mozilla Firefox\\#{reg.keys[0]}\\Main")
-              if entry = main.find { |key, type, data| key =~ /pathtoexe/i }
-                return entry.last
-              end
+              entry = main.find { |key, _type, _data| key =~ /pathtoexe/i }
+              return entry.last if entry
             end
           rescue LoadError
             # older JRuby or IronRuby does not have win32/registry
           rescue Win32::Registry::Error
           end
         end # class << self
-
       end # Binary
     end # Firefox
   end # WebDriver

data/lib/selenium/webdriver/firefox/driver.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+# 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
+# regarding copyright ownership.  The SFC licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Selenium
+  module WebDriver
+    module Firefox
+      module Driver
+        class << self
+
+          #
+          # Instantiates correct Firefox driver implementation
+          # @return [Marionette::Driver, Legacy::Driver]
+          #
+
+          def new(**opts)
+            if marionette?(opts)
+              Firefox::Marionette::Driver.new(opts)
+            else
+              Firefox::Legacy::Driver.new(opts)
+            end
+          end
+
+          private
+
+          def marionette?(opts)
+            opts.delete(:marionette) != false &&
+              (!opts[:desired_capabilities] || opts[:desired_capabilities][:marionette] != false)
+          end
+        end
+
+      end # Driver
+    end # Firefox
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/firefox/extension/prefs.json

@@ -2,15 +2,18 @@
   "frozen": {
     "app.update.auto": false,
     "app.update.enabled": false,
+    "browser.displayedE10SNotice": 4,
     "browser.download.manager.showWhenStarting": false,
     "browser.EULA.override": true,
     "browser.EULA.3.accepted": true,
     "browser.link.open_external": 2,
     "browser.link.open_newwindow": 2,
     "browser.offline": false,
+    "browser.reader.detectedFirstArticle": true,
     "browser.safebrowsing.enabled": false,
     "browser.safebrowsing.malware.enabled": false,
     "browser.search.update": false,
+    "browser.selfsupport.url" : "",
     "browser.sessionstore.resume_from_crash": false,
     "browser.shell.checkDefaultBrowser": false,
     "browser.tabs.warnOnClose": false,
@@ -25,43 +28,41 @@
     "dom.disable_open_during_load": false,
     "extensions.autoDisableScopes": 10,
     "extensions.blocklist.enabled": false,
-    "extensions.logging.enabled": true,
+    "extensions.checkCompatibility.nightly": false,
     "extensions.update.enabled": false,
     "extensions.update.notifyUser": false,
+    "javascript.enabled": true,
     "network.manage-offline-status": false,
     "network.http.phishy-userpass-length": 255,
     "offline-apps.allow_by_default": true,
     "prompts.tab_modal.enabled": false,
-    "security.csp.enable": false,
     "security.fileuri.origin_policy": 3,
     "security.fileuri.strict_origin_policy": false,
-    "security.warn_entering_secure": false,
-    "security.warn_entering_secure.show_once": false,
-    "security.warn_entering_weak": false,
-    "security.warn_entering_weak.show_once": false,
-    "security.warn_leaving_secure": false,
-    "security.warn_leaving_secure.show_once": false,
-    "security.warn_submit_insecure": false,
-    "security.warn_viewing_mixed": false,
-    "security.warn_viewing_mixed.show_once": false,
     "signon.rememberSignons": false,
     "toolkit.networkmanager.disable": true,
     "toolkit.telemetry.prompted": 2,
     "toolkit.telemetry.enabled": false,
-    "toolkit.telemetry.rejected": true
+    "toolkit.telemetry.rejected": true,
+    "xpinstall.signatures.required": false,
+    "xpinstall.whitelist.required": false
   },
   "mutable": {
     "browser.dom.window.dump.enabled": true,
+    "browser.laterrun.enabled": false,
     "browser.newtab.url": "about:blank",
     "browser.newtabpage.enabled": false,
     "browser.startup.page": 0,
     "browser.startup.homepage": "about:blank",
+    "browser.startup.homepage_override.mstone": "ignore",
+    "browser.usedOnWindows10.introURL": "about:blank",
     "dom.max_chrome_script_run_time": 30,
     "dom.max_script_run_time": 30,
     "dom.report_all_js_exceptions": true,
     "javascript.options.showInConsole": true,
-    "network.http.max-connections-per-server": 10,
+    "network.captive-portal-service.enabled": false,
+    "security.csp.enable": false,
     "startup.homepage_welcome_url": "about:blank",
+    "startup.homepage_welcome_url.additional": "about:blank",
     "webdriver_accept_untrusted_certs": true,
     "webdriver_assume_untrusted_issuer": true
   }