appium_lib_core 5.0.0.beta1 → 5.0.0.rc1

data/lib/appium_lib_core/{patch.rb → element.rb}

@@ -12,16 +12,12 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# rubocop:disable Style/ClassAndModuleChildren
 module Appium
   module Core
     # Implement useful features for element.
     # Patch for Selenium Webdriver.
-    class Selenium::WebDriver::Element
-      # To extend Appium related SearchContext into ::Selenium::WebDriver::Element
+    class Element < ::Selenium::WebDriver::Element
       include ::Appium::Core::Base::SearchContext
-
-      # TODO: Probably can remove own TakesScreenshot since Selenium 4
       include ::Appium::Core::Base::TakesScreenshot
 
       # Returns the value of attributes like below. Read each platform to know more details.
@@ -63,20 +59,20 @@ module Appium
       #
       # @example
       #
-      #   @driver.immediate_value 'hello'
+      #   element.immediate_value 'hello'
       #
       def immediate_value(*value)
-        @bridge.set_immediate_value(self, *value)
+        @bridge.set_immediate_value @id, *value
       end
 
       # Replace the value to element directly
       #
       # @example
       #
-      #   @driver.replace_value 'hello'
+      #   element.replace_value 'hello'
       #
       def replace_value(*value)
-        @bridge.replace_value(self, *value)
+        @bridge.replace_value @id, *value
       end
 
       # For use with location_rel.
@@ -112,7 +108,7 @@ module Appium
       #     element.screenshot #=> "iVBORw0KGgoAAAANSUhEUgAABDgAAAB+CAIAAABOPDa6AAAAAX"
       #
       def screenshot
-        bridge.take_element_screenshot(self)
+        bridge.element_screenshot @id
       end
 
       # Return an element screenshot in the given format
@@ -127,9 +123,9 @@ module Appium
       def screenshot_as(format)
         case format
         when :base64
-          bridge.take_element_screenshot(self)
+          bridge.element_screenshot @id
         when :png
-          bridge.take_element_screenshot(self).unpack('m')[0]
+          bridge.element_screenshot(@id).unpack('m')[0]
         else
           raise Core::Error::UnsupportedOperationError, "unsupported format: #{format.inspect}"
         end
@@ -152,7 +148,6 @@ module Appium
         end
         File.open(png_path, 'wb') { |f| f << screenshot_as(:png) }
       end
-    end
+    end # class Element
   end # module Core
 end # module Appium
-# rubocop:enable Style/ClassAndModuleChildren

data/lib/appium_lib_core/ios/uiautomation/patch.rb

@@ -21,7 +21,7 @@ module Appium
         # will trigger as soon as the file is required. in contrast a method
         # will trigger only when invoked.
         def self.patch_webdriver_element
-          ::Selenium::WebDriver::Element.class_eval do
+          ::Appium::Core::Element.class_eval do
             # Cross platform way of entering text into a textfield
             def type(text, driver)
               driver.execute_script %(au.getElement('#{ref}').setValue('#{text}');)

data/lib/appium_lib_core/version.rb

@@ -14,7 +14,7 @@
 
 module Appium
   module Core
-    VERSION = '5.0.0.beta1' unless defined? ::Appium::Core::VERSION
-    DATE    = '2021-03-21' unless defined? ::Appium::Core::DATE
+    VERSION = '5.0.0.rc1' unless defined? ::Appium::Core::VERSION
+    DATE    = '2021-09-09' unless defined? ::Appium::Core::DATE
   end
 end

data/lib/appium_lib_core.rb

@@ -17,11 +17,8 @@ require 'selenium-webdriver'
 require_relative 'appium_lib_core/version'
 require_relative 'appium_lib_core/common'
 require_relative 'appium_lib_core/driver'
-
 require_relative 'appium_lib_core/device'
-
-# Call patch after requiring other files
-require_relative 'appium_lib_core/patch'
+require_relative 'appium_lib_core/element'
 
 module Appium
   # convert all keys (including nested) to symbols
@@ -30,7 +27,7 @@ module Appium
   # https://github.com/rails/docrails/blob/a3b1105ada3da64acfa3843b164b14b734456a50/activesupport/lib/active_support/core_ext/hash/keys.rb#L84
   # @param [Hash] hash Hash value to make symbolise
   def self.symbolize_keys(hash)
-    raise ArgumentError, 'symbolize_keys requires a hash' unless hash.is_a? Hash
+    raise ::Appium::Core::Error::ArgumentError, 'symbolize_keys requires a hash' unless hash.is_a? Hash
 
     hash.each_with_object({}) do |pair, acc|
       key = begin

data/release_notes.md

@@ -1,3 +1,26 @@
+#### v4.7.0 2021-07-17
+
+- [0059974](https://github.com/appium/ruby_lib_core/commit/0059974b0b1d79a822db84d8b0169e8393e00ef9) Release 4.7.0
+- [0f93a52](https://github.com/appium/ruby_lib_core/commit/0f93a52bbdc44bf916c9b974fe9fd09d48e5ff39) test: add more example and test (#328)
+- [9e37b3b](https://github.com/appium/ruby_lib_core/commit/9e37b3bc15f72f7c0117a49945a3fe482598f374) feat: add satellites for Android emulators (#327)
+- [3063a73](https://github.com/appium/ruby_lib_core/commit/3063a73fa291dc378daa53b7df2e4b0b8a6f03d2) ci: calls quit_driver to ensure close the previous session
+- [43fb9e7](https://github.com/appium/ruby_lib_core/commit/43fb9e77f5492a92f4f8c5a5bda71be9c3a9e2c8) chore: tweak naming in an internal variable
+
+
+#### v4.6.0 2021-06-03
+
+- [0dacfab](https://github.com/appium/ruby_lib_core/commit/0dacfab1256e1447e1f7a5974dfcf48ee0a72b9d) Release 4.6.0
+- [b9f015d](https://github.com/appium/ruby_lib_core/commit/b9f015d7dea14964a0733f2385ebcff68da1e18e) feat: allow to add commands dynamically (#325)
+- [3de96ee](https://github.com/appium/ruby_lib_core/commit/3de96eea133ccbcbc5c4d77adc7d67c065a5a38c) chore(deps-dev): update webmock requirement from ~> 3.12.1 to ~> 3.13.0 (#324)
+- [f1a9e79](https://github.com/appium/ruby_lib_core/commit/f1a9e79f3bd4d134e125fc2ed9adcf3d085afc9a) docs: address func test code as working example
+- [eb85b1b](https://github.com/appium/ruby_lib_core/commit/eb85b1b26623436cb0aae95a00fef7bc2d795520) remove ; in a test
+- [1632637](https://github.com/appium/ruby_lib_core/commit/1632637fd872c0b80dfb97b8514ada6a7164eebf) chore(deps-dev): update rubocop requirement from = 1.11.0 to = 1.12.0 (#321)
+- [b9e47aa](https://github.com/appium/ruby_lib_core/commit/b9e47aa9b02f060ffa91e8410ab97dc87d3640a4) docs: add docstring
+- [954a2fe](https://github.com/appium/ruby_lib_core/commit/954a2feebb768a55b496a2614d9e4dd8b702fc1e) chore(deps-dev): update rubocop requirement from = 1.8.1 to = 1.11.0 (#316)
+- [a5b9651](https://github.com/appium/ruby_lib_core/commit/a5b9651aa349c10bd9759fedac6f09e27012a5e5) chore(deps-dev): update webmock requirement from ~> 3.11.0 to ~> 3.12.1 (#319)
+- [485c096](https://github.com/appium/ruby_lib_core/commit/485c096273178aa5e21f28d93545fd127cbb8735) test: add assertion
+
+
 #### v4.5.0 2021-03-14
 
 - [656230e](https://github.com/appium/ruby_lib_core/commit/656230e688ed86414c06efaa73bce7359933cc91) Release 4.5.0

data/script/commands.rb

@@ -23,17 +23,13 @@ module Script
 
     # Set commands implemented in this core library.
     #
-    # - implemented_w3c_commands:  All commands include ::Selenium::WebDriver::Remote::W3C::Bridge::COMMANDS
+    # - implemented_w3c_commands:  All commands include ::Selenium::WebDriver::Remote::Bridge::COMMANDS
     # - implemented_core_commands:  All commands except for selenium-webdriver's commands
-    # - webdriver_w3c_commands: ::Selenium::WebDriver::Remote::W3C::Bridge::COMMANDS
     #
     def initialize
       @spec_commands = nil
 
-      @implemented_w3c_commands = convert_driver_commands Appium::Core::Commands::W3C::COMMANDS
       @implemented_core_commands = convert_driver_commands Appium::Core::Commands::COMMANDS
-
-      @webdriver_w3c_commands = convert_driver_commands Appium::Core::Base::Commands::W3C
     end
 
     # Get the bellow url's file.
@@ -95,13 +91,6 @@ module Script
       result
     end
 
-    def diff_webdriver_w3c
-      result = compare_commands(@spec_commands, @webdriver_w3c_commands)
-      white_list.each { |v| result.delete v }
-      mjsonwp_spec.each { |v| result.delete v }
-      result
-    end
-
     def compare_commands(command1, with_command2)
       return {} if command1.nil?
       return command1 if with_command2.nil?

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: appium_lib_core
 version: !ruby/object:Gem::Version
-  version: 5.0.0.beta1
+  version: 5.0.0.rc1
 platform: ruby
 authors:
 - Kazuaki MATSUO
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-03-21 00:00:00.000000000 Z
+date: 2021-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.0.0.beta2
+        version: 4.0.0.rc1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 4.0.0.beta2
+        version: 4.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: faye-websocket
   requirement: !ruby/object:Gem::Requirement
@@ -114,28 +114,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.12.1
+        version: 3.14.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.12.1
+        version: 3.14.0
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.11.0
+        version: 1.12.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.11.0
+        version: 1.12.1
 - !ruby/object:Gem::Dependency
   name: appium_thor
   requirement: !ruby/object:Gem::Requirement
@@ -256,10 +256,10 @@ files:
 - lib/appium_lib_core/common.rb
 - lib/appium_lib_core/common/base.rb
 - lib/appium_lib_core/common/base/bridge.rb
-- lib/appium_lib_core/common/base/bridge/w3c.rb
 - lib/appium_lib_core/common/base/capabilities.rb
-- lib/appium_lib_core/common/base/command.rb
+- lib/appium_lib_core/common/base/device_ime.rb
 - lib/appium_lib_core/common/base/driver.rb
+- lib/appium_lib_core/common/base/driver_settings.rb
 - lib/appium_lib_core/common/base/has_location.rb
 - lib/appium_lib_core/common/base/has_network_connection.rb
 - lib/appium_lib_core/common/base/http_default.rb
@@ -269,8 +269,6 @@ files:
 - lib/appium_lib_core/common/base/screenshot.rb
 - lib/appium_lib_core/common/base/search_context.rb
 - lib/appium_lib_core/common/command.rb
-- lib/appium_lib_core/common/command/common.rb
-- lib/appium_lib_core/common/command/w3c.rb
 - lib/appium_lib_core/common/device/app_management.rb
 - lib/appium_lib_core/common/device/app_state.rb
 - lib/appium_lib_core/common/device/battery_status.rb
@@ -299,6 +297,7 @@ files:
 - lib/appium_lib_core/common/ws/websocket.rb
 - lib/appium_lib_core/device.rb
 - lib/appium_lib_core/driver.rb
+- lib/appium_lib_core/element.rb
 - lib/appium_lib_core/ios.rb
 - lib/appium_lib_core/ios/device.rb
 - lib/appium_lib_core/ios/device/clipboard.rb
@@ -315,7 +314,6 @@ files:
 - lib/appium_lib_core/mac2/bridge.rb
 - lib/appium_lib_core/mac2/device.rb
 - lib/appium_lib_core/mac2/device/screen.rb
-- lib/appium_lib_core/patch.rb
 - lib/appium_lib_core/version.rb
 - lib/appium_lib_core/windows.rb
 - lib/appium_lib_core/windows/bridge.rb
@@ -327,7 +325,7 @@ homepage: https://github.com/appium/ruby_lib_core/
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -342,8 +340,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: 1.3.1
 requirements: []
-rubygems_version: 3.1.2
-signing_key: 
+rubygems_version: 3.2.15
+signing_key:
 specification_version: 4
 summary: Minimal Ruby library for Appium.
 test_files: []

data/lib/appium_lib_core/common/base/bridge/w3c.rb

@@ -1,348 +0,0 @@
-# frozen_string_literal: true
-
-# Licensed 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 Appium
-  module Core
-    class Base
-      class Bridge
-        class W3C < ::Selenium::WebDriver::Remote::Bridge
-          include Device::DeviceLock
-          include Device::Keyboard
-          include Device::ImeActions
-          include Device::Setting
-          include Device::Context
-          include Device::Value
-          include Device::FileManagement
-          include Device::KeyEvent
-          include Device::ImageComparison
-          include Device::AppManagement
-          include Device::AppState
-          include Device::ScreenRecord::Command
-          include Device::Device
-          include Device::TouchActions
-          include Device::ExecuteDriver
-          include Device::Orientation
-
-          # TODO: For compatibility. Should remove.
-          def dialect
-            :w3c
-          end
-
-          # TODO: fixme
-          def browser
-            @browser ||= begin
-              name = @capabilities.browser_name
-              name ? name.tr(' ', '_').downcase.to_sym : 'unknown'
-            rescue KeyError
-              'unknown'
-            end
-          end
-
-          # Prefix for extra capability defined by W3C
-          APPIUM_PREFIX = 'appium:'
-
-          # Override
-          # Creates session handling both OSS and W3C dialects.
-          #
-          # @param [::Selenium::WebDriver::Remote::Capabilities, Hash] desired_capabilities A capability
-          # @return [::Selenium::WebDriver::Remote::Capabilities]
-          #
-          # @example
-          #
-          #   opts = {
-          #     caps: {
-          #       platformName: :ios,
-          #       automationName: 'XCUITest',
-          #       app: 'test/functional/app/UICatalog.app.zip',
-          #       platformVersion: '11.4',
-          #       deviceName: 'iPhone Simulator',
-          #       useNewWDA: true,
-          #     },
-          #     appium_lib: {
-          #       wait: 30
-          #     }
-          #   }
-          #   core = ::Appium::Core.for(caps)
-          #   driver = core.start_driver #=> driver.dialect == :w3c if the Appium server support W3C.
-          #
-          def create_session(desired_capabilities)
-            caps = add_appium_prefix(desired_capabilities)
-            response = execute(:new_session, {}, { capabilities: { firstMatch: [caps] } })
-
-            @session_id = response['sessionId']
-            capabilities = response['capabilities']
-
-            raise ::Selenium::WebDriver::Error::WebDriverError, 'no sessionId in returned payload' unless @session_id
-
-            @capabilities = json_create(capabilities)
-          end
-
-          # Append +appium:+ prefix for Appium following W3C spec
-          # https://www.w3.org/TR/webdriver/#dfn-validate-capabilities
-          #
-          # @param [::Selenium::WebDriver::Remote::Capabilities, Hash] capabilities A capability
-          # @return [::Selenium::WebDriver::Remote::Capabilities]
-          def add_appium_prefix(capabilities)
-            w3c_capabilities = ::Selenium::WebDriver::Remote::Capabilities.new
-
-            capabilities = capabilities.__send__(:capabilities) unless capabilities.is_a?(Hash)
-
-            capabilities.each do |name, value|
-              next if value.nil?
-              next if value.is_a?(String) && value.empty?
-
-              capability_name = name.to_s
-              w3c_name = extension_prefix?(capability_name) ? name : "#{APPIUM_PREFIX}#{capability_name}"
-
-              w3c_capabilities[w3c_name] = value
-            end
-
-            w3c_capabilities
-          end
-
-          private
-
-          def camel_case(str)
-            str.gsub(/_([a-z])/) { Regexp.last_match(1).upcase }
-          end
-
-          def extension_prefix?(capability_name)
-            snake_cased_capability_names = ::Selenium::WebDriver::Remote::Capabilities::KNOWN.map(&:to_s)
-            camel_cased_capability_names = snake_cased_capability_names.map { |v| camel_case(v) }
-
-            # Check 'EXTENSION_CAPABILITY_PATTERN'
-            snake_cased_capability_names.include?(capability_name) ||
-              camel_cased_capability_names.include?(capability_name) ||
-              capability_name.match(':')
-          end
-
-          def json_create(value)
-            @dialect = :w3c
-            ::Selenium::WebDriver::Remote::Capabilities.json_create(value)
-          end
-
-          public
-
-          def commands(command)
-            ::Appium::Core::Commands::W3C::COMMANDS[command]
-          end
-
-          # Returns all available sessions on the Appium server instance
-          def sessions
-            execute :get_all_sessions
-          end
-
-          def status
-            execute :status
-          end
-
-          # Perform touch actions for W3C module.
-          # Generate +touch+ pointer action here and users can use this via +driver.action+
-          # - https://seleniumhq.github.io/selenium/docs/api/rb/Selenium/WebDriver/W3CActionBuilder.html
-          # - https://seleniumhq.github.io/selenium/docs/api/rb/Selenium/WebDriver/PointerActions.html
-          # - https://seleniumhq.github.io/selenium/docs/api/rb/Selenium/WebDriver/KeyActions.html
-          #
-          # 'mouse' action is by default in the Ruby client. Appium server force the +mouse+ action to +touch+ once in
-          # the server side. So we don't consider the case.
-          #
-          # @example
-          #
-          #     element = @driver.find_element(:id, "some id")
-          #     @driver.action.click(element).perform # The 'click' is a part of 'PointerActions'
-          #
-          def action(async = false)
-            # Used for default duration of each touch actions
-            # Override from 250 milliseconds to 50 milliseconds
-            action_builder = super
-            action_builder.default_move_duration = 0.05
-            action_builder
-          end
-
-          # Port from MJSONWP
-          def get_timeouts
-            execute :get_timeouts
-          end
-
-          # Port from MJSONWP
-          def session_capabilities
-            ::Selenium::WebDriver::Remote::Capabilities.json_create execute(:get_capabilities)
-          end
-
-          # Port from MJSONWP
-          def send_keys_to_active_element(key)
-            text = ::Selenium::WebDriver::Keys.encode(key).join('')
-            execute :send_keys_to_active_element, {}, { value: text.split(//) }
-          end
-
-          # For Appium
-          # override
-          def page_source
-            # For W3C
-            # execute_script('var source = document.documentElement.outerHTML;' \
-            # 'if (!source) { source = new XMLSerializer().serializeToString(document); }' \
-            # 'return source;')
-            execute :get_page_source
-          end
-
-          # For Appium
-          # override
-          def element_displayed?(element)
-            # For W3C
-            # https://github.com/SeleniumHQ/selenium/commit/b618499adcc3a9f667590652c5757c0caa703289
-            # execute_atom :isDisplayed, element
-            execute :is_element_displayed, id: element.ref
-          end
-
-          # For Appium
-          # override
-          def element_attribute(element, name)
-            # For W3C in Selenium Client
-            # execute_atom :getAttribute, element, name
-            execute :get_element_attribute, id: element.ref, name: name
-          end
-
-          # For Appium
-          # override
-          def find_element_by(how, what, parent = nil)
-            how, what = convert_locators(how, what)
-
-            id = if parent
-                   execute :find_child_element, { id: parent }, { using: how, value: what }
-                 else
-                   execute :find_element, {}, { using: how, value: what }
-                 end
-            ::Selenium::WebDriver::Element.new self, element_id_from(id)
-          end
-
-          # For Appium
-          # override
-          def find_elements_by(how, what, parent = nil)
-            how, what = convert_locators(how, what)
-
-            ids = if parent
-                    execute :find_child_elements, { id: parent }, { using: how, value: what }
-                  else
-                    execute :find_elements, {}, { using: how, value: what }
-                  end
-
-            ids.map { |id| ::Selenium::WebDriver::Element.new self, element_id_from(id) }
-          end
-
-          # For Appium
-          # @param [Hash] id The id which can get as a response from server
-          # @return [::Selenium::WebDriver::Element]
-          def convert_to_element(id)
-            ::Selenium::WebDriver::Element.new self, element_id_from(id)
-          end
-
-          # For Appium
-          # override
-          # called in 'extend DriverExtensions::HasNetworkConnection'
-          def network_connection
-            execute :get_network_connection
-          end
-
-          # For Appium
-          # override
-          # called in 'extend DriverExtensions::HasNetworkConnection'
-          def network_connection=(type)
-            execute :set_network_connection, {}, { parameters: { type: type } }
-          end
-
-          # For Appium
-          # No implementation for W3C webdriver module
-          # called in 'extend DriverExtensions::HasLocation'
-          def location
-            obj = execute(:get_location) || {}
-            ::Selenium::WebDriver::Location.new obj['latitude'], obj['longitude'], obj['altitude']
-          end
-
-          # For Appium
-          # No implementation for W3C webdriver module
-          def set_location(lat, lon, alt = 0.0, speed: nil)
-            loc = { latitude: lat, longitude: lon, altitude: alt }
-            loc[:speed] = speed unless speed.nil?
-            execute :set_location, {}, { location: loc }
-          end
-
-          #
-          # logs
-          #
-          # For Appium
-          # No implementation for W3C webdriver module
-          def available_log_types
-            types = execute :get_available_log_types
-            Array(types).map(&:to_sym)
-          end
-
-          # For Appium
-          # No implementation for W3C webdriver module
-          def log(type)
-            data = execute :get_log, {}, { type: type.to_s }
-
-            Array(data).map do |l|
-              begin
-                ::Selenium::WebDriver::LogEntry.new l.fetch('level', 'UNKNOWN'), l.fetch('timestamp'), l.fetch('message')
-              rescue KeyError
-                next
-              end
-            end
-          end
-
-          # For Appium
-          def log_event(vendor, event)
-            execute :post_log_event, {}, { vendor: vendor, event: event }
-          end
-
-          # For Appium
-          def log_events(type = nil)
-            args = {}
-            args['type'] = type unless type.nil?
-
-            execute :get_log_events, {}, args
-          end
-
-          def take_viewport_screenshot
-            execute_script('mobile: viewportScreenshot')
-          end
-
-          def take_element_screenshot(element)
-            execute :take_element_screenshot, id: element.ref
-          end
-
-          private
-
-          # Don't convert locators for Appium Client
-          # TODO: Only for Appium. Ideally, we'd like to keep the selenium-webdriver
-          def convert_locators(how, what)
-            # case how
-            # when 'class name'
-            #   how = 'css selector'
-            #   what = ".#{escape_css(what)}"
-            # when 'id'
-            #   how = 'css selector'
-            #   what = "##{escape_css(what)}"
-            # when 'name'
-            #   how = 'css selector'
-            #   what = "*[name='#{escape_css(what)}']"
-            # when 'tag name'
-            #   how = 'css selector'
-            # end
-            [how, what]
-          end
-        end # class W3C
-      end # class Bridge
-    end # class Base
-  end # module Core
-end # module Appium