selenium-webdriver 3.14.1 → 3.141.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: bc2fa60c4b4dcb28481e549ef426d29ae729aca8
-  data.tar.gz: a284aba391e1e3ad1ce0b77aed8e5beba4f82465
+  metadata.gz: 66ea2f3150d90a9226b8071c0f3d7f68a1286de0
+  data.tar.gz: 4b52f675b096ccb1f99ece3b84bbea29dd41906f
 SHA512:
-  metadata.gz: fb9dfe880130c48329c5defaae8fefa37dded984ae790937f2336c399b488c2d0d24fc82acd6871e3bf46a28163cc61e3d2d5dc43dab8a657841c9a0a1b1a24d
-  data.tar.gz: 18ee7fdb743fa5805d4f7c8778f9fe490713f89e3319da60e88b62e4d561bd6aa563b4b31e3f6b724cd69faebf61c8eb92d637d1b6125bd5ccc8ee5dec0cb24d
+  metadata.gz: 267dce8aada9928450f1c59ee442b40ab3c6551155cc9127c635ae5abb641d272c1d32855f654f903b6dcb866ecf60c5608aa3c7e8f7027e928e71e609425753
+  data.tar.gz: f8fe782853b7bf314ac2c24bdb33bd3fecdd8001a603b8a448b08c296d195a9b791da4ffcb9b92454617a8d668cf0a1eb7ad191cf055363074897857831c791c

data/CHANGES

@@ -1,3 +1,29 @@
+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)
 ===================
 

data/lib/selenium/server.rb

@@ -199,7 +199,7 @@ module Selenium
       stop_process if @process
       poll_for_shutdown
 
-      @log_file.close if @log_file
+      @log_file.close if defined?(@log_file)
     end
 
     def webdriver_url

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

@@ -23,7 +23,7 @@ module Selenium
         COMMANDS = {
           get_network_conditions: [:get, '/session/:session_id/chromium/network_conditions'.freeze],
           set_network_conditions: [:post, '/session/:session_id/chromium/network_conditions'.freeze],
-          send_command: [:post, '/session/:session_id/chromium/send_command'.freeze]
+          send_command: [:post, '/session/:session_id/goog/cdp/execute'.freeze]
         }.freeze
 
         def commands(command)

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

@@ -28,6 +28,7 @@ module Selenium
         include DriverExtensions::HasNetworkConditions
         include DriverExtensions::HasTouchScreen
         include DriverExtensions::HasWebStorage
+        include DriverExtensions::HasLocation
         include DriverExtensions::TakesScreenshot
         include DriverExtensions::DownloadsFiles
 

data/lib/selenium/webdriver/edge.rb

@@ -19,6 +19,7 @@ require 'net/http'
 
 require 'selenium/webdriver/edge/bridge'
 require 'selenium/webdriver/edge/driver'
+require 'selenium/webdriver/edge/options'
 require 'selenium/webdriver/edge/service'
 
 module Selenium

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

@@ -0,0 +1,77 @@
+# 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/remote/bridge.rb

@@ -50,7 +50,7 @@ module Selenium
           end
 
           bridge = new(opts)
-          capabilities = bridge.create_session(desired_capabilities)
+          capabilities = bridge.create_session(desired_capabilities, opts.delete(:options))
 
           case bridge.dialect
           when :oss
@@ -73,8 +73,10 @@ module Selenium
 
         def initialize(opts = {})
           opts = opts.dup
+
           http_client = opts.delete(:http_client) { Http::Default.new }
           url = opts.delete(:url) { "http://#{Platform.localhost}:#{PORT}/wd/hub" }
+          opts.delete(:options)
 
           unless opts.empty?
             raise ArgumentError, "unknown option#{'s' if opts.size != 1}: #{opts.inspect}"
@@ -93,8 +95,8 @@ module Selenium
         # Creates session handling both OSS and W3C dialects.
         #
 
-        def create_session(desired_capabilities)
-          response = execute(:new_session, {}, merged_capabilities(desired_capabilities))
+        def create_session(desired_capabilities, options = nil)
+          response = execute(:new_session, {}, merged_capabilities(desired_capabilities, options))
 
           @session_id = response['sessionId']
           oss_status = response['status']
@@ -173,8 +175,9 @@ module Selenium
           COMMANDS[command]
         end
 
-        def merged_capabilities(oss_capabilities)
+        def merged_capabilities(oss_capabilities, options = nil)
           w3c_capabilities = W3C::Capabilities.from_oss(oss_capabilities)
+          w3c_capabilities.merge!(options.as_json) if options
 
           {
             desiredCapabilities: oss_capabilities,

data/lib/selenium/webdriver/safari.rb

@@ -17,6 +17,7 @@
 
 require 'selenium/webdriver/safari/bridge'
 require 'selenium/webdriver/safari/driver'
+require 'selenium/webdriver/safari/options'
 require 'selenium/webdriver/safari/service'
 
 module Selenium

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

@@ -30,7 +30,7 @@ module Selenium
         include DriverExtensions::TakesScreenshot
 
         def initialize(opts = {})
-          opts[:desired_capabilities] ||= Remote::Capabilities.safari
+          opts[:desired_capabilities] = create_capabilities(opts)
 
           unless opts.key?(:url)
             driver_path = opts.delete(:driver_path) || Safari.driver_path
@@ -55,6 +55,15 @@ module Selenium
           @service.stop if @service
         end
 
+        private
+
+        def create_capabilities(opts = {})
+          caps = opts.delete(:desired_capabilities) { Remote::Capabilities.safari }
+          options = opts.delete(:options) { Options.new }
+          caps.merge!(options.as_json)
+          caps
+        end
+
       end # Driver
     end # Safari
   end # WebDriver

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

@@ -0,0 +1,58 @@
+# 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 Safari
+      class Options
+        attr_accessor :automatic_inspection, :automatic_profiling
+
+        #
+        # Create a new Options instance for W3C-capable versions of Safari.
+        #
+        # @example
+        #   options = Selenium::WebDriver::Safari::Options.new(automatic_inspection: true)
+        #   driver = Selenium::WebDriver.for :safari, options: options
+        #
+        # @param [Hash] opts the pre-defined options to create the Safari::Options with
+        # @option opts [Boolean] :automatic_inspection Preloads Web Inspector and JavaScript debugger. Default is false
+        # @option opts [Boolean] :automatic_profiling Preloads Web Inspector and starts a timeline recording. Default is false
+        #
+        # @see https://developer.apple.com/documentation/webkit/about_webdriver_for_safari
+        #
+
+        def initialize(**opts)
+          @automatic_inspection = opts.delete(:automatic_inspection) || false
+          @automatic_profiling = opts.delete(:automatic_profiling) || false
+        end
+
+        #
+        # @api private
+        #
+
+        def as_json(*)
+          opts = {}
+
+          opts['safari:automaticInspection'] = true if @automatic_inspection
+          opts['safari:automaticProfiling'] = true if @automatic_profiling
+
+          opts
+        end
+      end # Options
+    end # Safari
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/version.rb

@@ -17,6 +17,6 @@
 
 module Selenium
   module WebDriver
-    VERSION = '3.14.1'.freeze
+    VERSION = '3.141.0'.freeze
   end # WebDriver
 end # Selenium

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: selenium-webdriver
 version: !ruby/object:Gem::Version
-  version: 3.14.1
+  version: 3.141.0
 platform: ruby
 authors:
 - Alex Rodionov
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-10-04 00:00:00.000000000 Z
+date: 2018-11-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement
@@ -202,6 +202,7 @@ files:
 - lib/selenium/webdriver/edge.rb
 - lib/selenium/webdriver/edge/bridge.rb
 - lib/selenium/webdriver/edge/driver.rb
+- lib/selenium/webdriver/edge/options.rb
 - lib/selenium/webdriver/edge/service.rb
 - lib/selenium/webdriver/firefox.rb
 - lib/selenium/webdriver/firefox/binary.rb
@@ -242,6 +243,7 @@ files:
 - lib/selenium/webdriver/safari.rb
 - lib/selenium/webdriver/safari/bridge.rb
 - lib/selenium/webdriver/safari/driver.rb
+- lib/selenium/webdriver/safari/options.rb
 - lib/selenium/webdriver/safari/service.rb
 - lib/selenium/webdriver/support.rb
 - lib/selenium/webdriver/support/abstract_event_listener.rb