selenium-webdriver 2.53.4 → 3.8.0

data/lib/selenium/webdriver/remote/w3c_capabilities.rb

@@ -1,236 +0,0 @@
-# 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
-# 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 Remote
-      #
-      # Specification of the desired and/or actual capabilities of the browser that the
-      # server is being asked to create.
-      #
-      class W3CCapabilities
-
-        DEFAULTS = {
-          :browser_name => '',
-          :browser_version => :any,
-          :platform_name => :any,
-          :platform_version => :any,
-          :accept_ssl_certs => false,
-          :page_load_strategy => 'normal',
-          :proxy => nil
-        }
-
-        KNOWN = [
-            :remote_session_id,
-            :xul_app_id,
-            :raise_accessibility_exceptions,
-            :rotatable,
-            :app_build_id,
-            :device
-        ]
-
-        (DEFAULTS.keys + KNOWN).each do |key|
-          define_method key do
-            @capabilities.fetch(key)
-          end
-
-          define_method "#{key}=" do |value|
-            @capabilities[key] = value
-          end
-        end
-
-        #
-        # Backward compatibility
-        #
-
-        alias_method :version, :browser_version
-        alias_method :version=, :browser_version=
-        alias_method :platform, :platform_name
-        alias_method :platform=, :platform_name=
-
-        #
-        # Convenience methods for the common choices.
-        #
-
-        class << self
-
-          def edge(opts = {})
-            new({
-              :browser_name => "MicrosoftEdge",
-              :platform => :windows,
-                }.merge(opts))
-          end
-
-          def firefox(opts = {})
-            opts[:browser_version] = opts.delete :version
-            opts[:platform_name] = opts.delete :platform
-
-            new({
-              :browser_name => "firefox",
-              :marionette => true
-                }.merge(opts))
-          end
-
-          alias_method :ff, :firefox
-
-          def w3c?(opts = {})
-            opts[:desired_capabilities].is_a?(W3CCapabilities) || opts[:marionette]
-          end
-
-          #
-          # @api private
-          #
-
-          def json_create(data)
-            data = data.dup
-
-            # Convert due to Remote Driver implementation
-            data["browserVersion"] = data.delete("version") if data.key? "version"
-            data["platformName"] = data.delete("platform") if data.key? "platform"
-
-            caps = new
-            caps.browser_name = data.delete("browserName") if data.key? "browserName"
-            caps.browser_version = data.delete("browserVersion") if data.key? "browserVersion"
-            caps.platform_name = data.delete("platformName") if data.key? "platformName"
-            caps.platform_version = data.delete("platformVersion") if data.key? "platformVersion"
-            caps.accept_ssl_certs = data.delete("acceptSslCerts") if data.key? "acceptSslCerts"
-            caps.page_load_strategy = data.delete("pageLoadStrategy") if data.key? "pageloadStrategy"
-            proxy = data.delete('proxy')
-            caps.proxy = Proxy.json_create(proxy) unless proxy.nil? || proxy.empty?
-
-            # Remote Server Specific
-            caps[:remote_session_id] = data.delete('webdriver.remote.sessionid')
-
-            # Obsolete capabilities returned by Remote Server
-            data.delete("javascriptEnabled")
-            data.delete('cssSelectorsEnabled')
-
-            # Marionette Specific
-            caps[:xul_app_id] = data.delete("XULappId")
-            caps[:raise_accessibility_exceptions] = data.delete('raisesAccessibilityExceptions')
-            caps[:rotatable] = data.delete('rotatable')
-            caps[:app_build_id] = data.delete('appBuildId')
-            caps[:device] = data.delete('device')
-
-            # any remaining pairs will be added as is, with no conversion
-            caps.merge!(data)
-            caps
-          end
-        end
-
-        # @param [Hash] opts
-        # @option :browser_name             [String] required browser name
-        # @option :browser_version          [String] required browser version number
-        # @option :platform_name            [Symbol] one of :any, :win, :mac, or :x
-        # @option :platform_version         [String] required platform version number
-        # @option :accept_ssl_certs         [Boolean] does the driver accept SSL Cerfifications?
-        # @option :proxy                    [Selenium::WebDriver::Proxy, Hash] proxy configuration
-        #
-        # @api public
-        #
-
-        def initialize(opts = {})
-          @capabilities = DEFAULTS.merge(opts)
-          self.proxy = opts.delete(:proxy)
-        end
-
-        #
-        # Allows setting arbitrary capabilities.
-        #
-
-        def []=(key, value)
-          @capabilities[key] = value
-        end
-
-        def [](key)
-          @capabilities[key]
-        end
-
-        def merge!(other)
-          if other.respond_to?(:capabilities, true) && other.capabilities.kind_of?(Hash)
-            @capabilities.merge! other.capabilities
-          elsif other.kind_of? Hash
-            @capabilities.merge! other
-          else
-            raise ArgumentError, "argument should be a Hash or implement #capabilities"
-          end
-        end
-
-        def proxy=(proxy)
-          case proxy
-          when Hash
-            @capabilities[:proxy] = Proxy.new(proxy)
-          when Proxy, nil
-            @capabilities[:proxy] = proxy
-          else
-            raise TypeError, "expected Hash or #{Proxy.name}, got #{proxy.inspect}:#{proxy.class}"
-          end
-        end
-
-        # @api private
-        #
-
-        def as_json(opts = nil)
-          hash = {}
-
-          @capabilities.each do |key, value|
-            case key
-            when :platform
-              hash['platform'] = value.to_s.upcase
-            when :proxy
-              hash['proxy'] = value.as_json if value
-            when String, :firefox_binary
-              hash[key.to_s] = value
-            when Symbol
-              hash[camel_case(key.to_s)] = value
-            else
-              raise TypeError, "expected String or Symbol, got #{key.inspect}:#{key.class} / #{value.inspect}"
-            end
-          end
-
-          hash
-        end
-
-        def to_json(*args)
-          JSON.generate as_json
-        end
-
-        def ==(other)
-          return false unless other.kind_of? self.class
-          as_json == other.as_json
-        end
-
-        alias_method :eql?, :==
-
-        protected
-
-        def capabilities
-          @capabilities
-        end
-
-        private
-
-        def camel_case(str)
-          str.gsub(/_([a-z])/) { $1.upcase }
-        end
-
-      end # W3CCapabilities
-    end # Remote
-  end # WebDriver
-end # Selenium

data/lib/selenium/webdriver/remote/w3c_commands.rb

@@ -1,132 +0,0 @@
-# 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
-# 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.
-
-class Selenium::WebDriver::Remote::W3CBridge
-
-  #
-  # http://www.w3.org/TR/2015/WD-webdriver-20150918/#list-of-endpoints
-  #
-
-  #
-  # session handling
-  #
-
-  command :newSession,                 :post,    "session"
-  command :deleteSession,              :delete,  "session/:session_id"
-
-
-  #
-  # basic driver
-  #
-
-  command :get,                        :post,    "session/:session_id/url"
-  command :getCurrentUrl,              :get,     "session/:session_id/url"
-  command :back,                       :post,    "session/:session_id/back"
-  command :forward,                    :post,    "session/:session_id/forward"
-  command :refresh,                    :post,    "session/:session_id/refresh"
-  command :getTitle,                   :get,     "session/:session_id/title"
-
-  #
-  # window and Frame handling
-  #
-
-  command :getWindowHandle,            :get,     "session/:session_id/window"
-  command :closeWindow,                :delete,  "session/:session_id/window"
-  command :switchToWindow,             :post,    "session/:session_id/window"
-  command :getWindowHandles,           :get,     "session/:session_id/window/handles"
-  command :fullscreenWindow,           :post,    "session/:session_id/window/fullscreen"
-  command :maximizeWindow,             :post,    "session/:session_id/window/maximize"
-  command :setWindowSize,              :post,    "session/:session_id/window/size"
-  command :getWindowSize,              :get,     "session/:session_id/window/size"
-  command :switchToFrame,              :post,    "session/:session_id/frame"
-  command :switchToParentFrame,        :post,    "session/:session_id/frame/parent"
-
-  #
-  # element
-  #
-
-  command :findElement,                :post,    "session/:session_id/element"
-  command :findElements,               :post,    "session/:session_id/elements"
-  command :findChildElement,           :post,    "session/:session_id/element/:id/element"
-  command :findChildElements,          :post,    "session/:session_id/element/:id/elements"
-  command :getActiveElement,           :get,     "session/:session_id/element/active"
-  command :isElementSelected,          :get,     "session/:session_id/element/:id/selected"
-  command :getElementAttribute,        :get,     "session/:session_id/element/:id/attribute/:name"
-  command :getElementProperty,         :get,     "session/:session_id/element/:id/property/:name"
-  command :getElementCssValue,         :get,     "session/:session_id/element/:id/css/:property_name"
-  command :getElementText,             :get,     "session/:session_id/element/:id/text"
-  command :getElementTagName,          :get,     "session/:session_id/element/:id/name"
-  command :getElementRect,             :get,     "session/:session_id/element/:id/rect"
-  command :isElementEnabled,           :get,     "session/:session_id/element/:id/enabled"
-
-  #
-  # script execution
-  #
-
-  command :executeScript,              :post,    "session/:session_id/execute/sync"
-  command :executeAsyncScript,         :post,    "session/:session_id/execute/async"
-
-  #
-  # cookies
-  #
-
-  command :getAllCookies,              :get,     "session/:session_id/cookie"
-  command :getCookie,                  :get,     "session/:session_id/cookie/:name"
-  command :addCookie,                  :post,    "session/:session_id/cookie"
-  command :deleteCookie,               :delete,  "session/:session_id/cookie/:name"
-
-  #
-  # timeouts
-  #
-
-  command :setTimeout,                 :post,    "session/:session_id/timeouts"
-
-  #
-  # actions
-  #
-
-  command :actions,                    :post,    "session/:session_id/actions"
-
-
-  #
-  # Element Operations
-  #
-
-  command :elementClick,               :post,    "session/:session_id/element/:id/click"
-  command :elementTap,                 :post,    "session/:session_id/element/:id/tap"
-  command :elementClear,               :post,    "session/:session_id/element/:id/clear"
-  command :elementSendKeys,            :post,    "session/:session_id/element/:id/value"
-
-  #
-  # alerts
-  #
-
-  command :dismissAlert,               :post,    "session/:session_id/alert/dismiss"
-  command :acceptAlert,                :post,    "session/:session_id/alert/accept"
-  command :getAlertText,               :get,     "session/:session_id/alert/text"
-  command :sendAlertText,              :post,    "session/:session_id/alert/text"
-
-  #
-  # screenshot
-  #
-
-  command :takeScreenshot,             :get,     "session/:session_id/screenshot"
-  command :takeElementScreenshot,      :get,     "session/:session_id/element/:id/screenshot"
-
-end

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

@@ -1,135 +0,0 @@
-# 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
-# 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 Bridge < Remote::Bridge
-        COMMAND_TIMEOUT = 60
-
-        def initialize(opts = {})
-          command_timeout = Integer(opts[:timeout] || COMMAND_TIMEOUT)
-          safari_options  = opts.delete(:options) || Safari::Options.new(opts)
-          capabilities    = merge_capabilities(opts, safari_options)
-
-          @command_id ||= 0
-
-          # TODO: handle safari_opts['cleanSession']
-          @server = Server.new(safari_options.port, command_timeout)
-          @server.start
-
-          @safari = Browser.new
-          @safari.start(prepare_connect_file)
-
-          @server.wait_for_connection
-
-          super(desired_capabilities: capabilities)
-        end
-
-        def quit
-          super
-
-          @server.stop
-          @safari.stop
-        end
-
-        def driver_extensions
-          [
-            DriverExtensions::TakesScreenshot,
-            DriverExtensions::HasInputDevices
-          ]
-        end
-
-        private
-
-        def create_session(desired_capabilities)
-          resp = raw_execute :newSession, {}, :desiredCapabilities => desired_capabilities
-          Remote::Capabilities.json_create resp.fetch('value')
-        end
-
-        def raw_execute(command, opts = {}, command_hash = nil)
-          @command_id += 1
-
-          params = {}
-          opts.each do |key, value|
-            params[camel_case(key.to_s)] = value
-          end
-
-          params.merge!(command_hash) if command_hash
-
-          @server.send(
-            :origin  => "webdriver",
-            :type    => "command",
-            :command => { :id => @command_id.to_s, :name => command, :parameters => params}
-          )
-
-          raw = @server.receive
-          response = raw.fetch('response')
-
-          status_code = response['status']
-          if status_code != 0
-            raise Error.for_code(status_code), response['value']['message']
-          end
-
-          if raw['id'].to_s != @command_id.to_s
-            raise Error::WebDriverError, "response id does not match command id: #{raw['id']} != #{@command_id}"
-          end
-
-          response
-        end
-
-        def camel_case(str)
-          parts = str.split('_')
-          parts[1..-1].map { |e| e.capitalize! }
-
-          parts.join
-        end
-
-        def prepare_connect_file
-          # TODO: use tempfile?
-          path = File.join(Dir.tmpdir, "safaridriver-#{Time.now.usec}.html")
-
-          File.open(path, 'w') do |io|
-            io << "<!DOCTYPE html><script>window.location = '#{@server.uri}';</script>"
-          end
-
-          FileReaper << path
-          path.gsub! "/", "\\" if Platform.windows?
-
-          path
-        end
-
-        def merge_capabilities(opts, safari_options)
-          caps  = safari_options.to_capabilities
-          other = opts[:desired_capabilities]
-
-          if other
-            other = opts[:desired_capabilities].as_json
-            caps['safari.options'].merge!(other.delete('safari.options') || {})
-            caps.merge!(other)
-          end
-
-          caps
-        end
-
-      end # Bridge
-    end # Safari
-  end # WebDriver
-end # Selenium