selenium-webdriver 3.142.7 → 4.0.0.alpha1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c9f40e154da198fff9e277f0613042c22fff6c98
-  data.tar.gz: 33cc734e78b08e66c00a4c73f51c635d97c86fe6
+  metadata.gz: bc17a0dfe5aefbf024e5e6c64082ba16209c7f36
+  data.tar.gz: 6e7cda3f69ed3fcaaa591b9720b7674a3f8d7a23
 SHA512:
-  metadata.gz: b40eb2e74a284b21ee31924f7cf20b878c7ab6ebcfe7848b21ad163165c80467c9d3a6fa6252ca74680b82db7186e8c1b73a2ac5f4d37501b0dfa16763ec19b9
-  data.tar.gz: bc9e9e0128888f3efe33f59160b677cc88655bf986877c534053adf915f3b39a78ff1d88e9b2d80753c1aba49af92f1796bb4f774ca68114027594813cc26ad3
+  metadata.gz: 2dfdf006f048202deedb179a6279c5000082e298ecc29c97806dc1199517bfa625ee45d6be2a2f88ece82869a5b4f593795b3940aa781539740a91d2a8a33523
+  data.tar.gz: 85a754811a838367f4a93699b1e44b58eb3493a0ec44d9367d7be566a28ec29a820f89befda4d7f73383443d999f87d76f4cc0b484b920600c30d2b15289e496

data/CHANGES

@@ -1,53 +1,31 @@
-3.142.7 (2019-12-27)
-====================
-
-Ruby:
-  * Fix keyword argument deprecations in Ruby 2.7 (thanks @connorshea)
-
-3.142.6 (2019-10-04)
-====================
-
-Ruby:
-  * Loosen ChildProcess dependency so that 3.0+ can be used (thanks @jaredbeck)
-
-3.142.5 (2019-10-01)
-====================
+4.0.0.alpha1 (unreleased)
+=========================
 
 Ruby:
-  * Loosen RubyZip dependency so that 1.3+ can be used (thanks @vtamara)
-
-3.142.4 (2019-09-02)
-====================
-
-Chrome:
-  * Added support for new command for getting logs in ChromeDriver 76+
-    with W3C mode on
-
-3.142.3 (2019-05-21)
-====================
-
-Firefox:
-  * Fixed a regression when Firefox binary path was not sent to GeckoDriver
-    by default and browser could not be located (issue #7219)
-
-
-3.142.2 (2019-05-11)
-====================
+  * Removed Mouse and Keyboard as their implementations are not compliant to WebDriver specification
+  * Removed TouchActionBuilder as its implementation is not compliant to WebDriver specification
+  * Change ActionBuilder to be fully compliant to WebDriver specification
+  * Change Manager to be fully compliant to WebDriver specification
+  * Removed all deprecated errors that are not compliant to WebDriver specification
+  * Update minimum required Ruby version to 2.4
+  * Changed capabilities to use only those that are compliant to WebDriver specification
+  * Removed deprecated timeout setter on default HTTP client
+  * Removed deprecated Remote::W3C::Capabilities
+  * Fixed an issue when services are not shutdown properly
 
 Chrome:
-  * Fixed an issue when getting/setting network conditions and sending CDP
-    commands didn't work with Grid (issue #7174)
+  * Removed support for OSS mode - use W3C mode instead by using
+    Selenium::WebDriver::Chrome::Options.new(options: {w3c: true})
 
-Safari:
-  * Fixed an issue when getting/setting permissions and attaching debugger
-    didn't work with Grid (issue #7174)
-
-3.142.1 (2019-05-07)
-====================
+PhantomJS:
+  * Removed support for PhantomJS driver
 
 Firefox:
-  * Fixed an issue when processing error in legacy driver would result
-    in NoMethodError (issue #7178)
+  * Removed support for legacy Firefox driver - use GeckoDriver instead
+  * Removed deprecated outdated capabilities
+  * Fixed an issue when passing :profile string to Firefox::Options.new would
+    result in NoMethodError. Now it will find a profile with such name on your
+    system and use it accordingly (issue #7119)
 
 3.142.0 (2019-04-24)
 ====================

data/lib/selenium/webdriver.rb

@@ -39,7 +39,6 @@ module Selenium
     autoload :Edge,      'selenium/webdriver/edge'
     autoload :Firefox,   'selenium/webdriver/firefox'
     autoload :IE,        'selenium/webdriver/ie'
-    autoload :PhantomJS, 'selenium/webdriver/phantomjs'
     autoload :Remote,    'selenium/webdriver/remote'
     autoload :Safari,    'selenium/webdriver/safari'
     autoload :Support,   'selenium/webdriver/support'
@@ -54,10 +53,10 @@ module Selenium
     # Create a new Driver instance with the correct bridge for the given browser
     #
     # @overload for(browser)
-    #   @param [:ie, :internet_explorer, :edge, :remote, :chrome, :firefox, :ff, :phantomjs, :safari] browser The browser to
+    #   @param [:ie, :internet_explorer, :edge, :remote, :chrome, :firefox, :ff, :safari] browser The browser to
     #     create the driver for
     # @overload for(browser, opts)
-    #   @param [:ie, :internet_explorer, :edge, :remote, :chrome, :firefox, :ff, :phantomjs, :safari] browser The browser to
+    #   @param [:ie, :internet_explorer, :edge, :remote, :chrome, :firefox, :ff, :safari] browser The browser to
     #     create the driver for
     #   @param [Hash] opts Options passed to Driver.new
     #
@@ -68,7 +67,6 @@ module Selenium
     # @see Selenium::WebDriver::IE::Driver
     # @see Selenium::WebDriver::Edge::Driver
     # @see Selenium::WebDriver::Chrome::Driver
-    # @see Selenium::WebDriver::PhantomJS::Driver
     # @see Selenium::WebDriver::Safari::Driver
     #
     # @example

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

@@ -23,11 +23,9 @@ module Selenium
       module Bridge
 
         COMMANDS = {
-          get_network_conditions: [:get, 'session/:session_id/chromium/network_conditions'],
-          set_network_conditions: [:post, 'session/:session_id/chromium/network_conditions'],
-          send_command: [:post, 'session/:session_id/goog/cdp/execute'],
-          get_available_log_types: [:get, 'session/:session_id/se/log/types'],
-          get_log: [:post, 'session/:session_id/se/log']
+          get_network_conditions: [:get, '/session/:session_id/chromium/network_conditions'],
+          set_network_conditions: [:post, '/session/:session_id/chromium/network_conditions'],
+          send_command: [:post, '/session/:session_id/goog/cdp/execute']
         }.freeze
 
         def commands(command)
@@ -46,22 +44,6 @@ module Selenium
           execute :set_network_conditions, {}, {network_conditions: conditions}
         end
 
-        def available_log_types
-          types = execute :get_available_log_types
-          Array(types).map(&:to_sym)
-        end
-
-        def log(type)
-          data = execute :get_log, {}, {type: type.to_s}
-
-          Array(data).map do |l|
-            begin
-              LogEntry.new l.fetch('level', 'UNKNOWN'), l.fetch('timestamp'), l.fetch('message')
-            rescue KeyError
-              next
-            end
-          end
-        end
       end # Bridge
     end # Chrome
   end # WebDriver

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

@@ -28,7 +28,6 @@ module Selenium
 
       class Driver < WebDriver::Driver
         include DriverExtensions::HasNetworkConditions
-        include DriverExtensions::HasTouchScreen
         include DriverExtensions::HasWebStorage
         include DriverExtensions::HasLocation
         include DriverExtensions::TakesScreenshot
@@ -40,8 +39,11 @@ module Selenium
           opts[:url] ||= service_url(opts)
 
           listener = opts.delete(:listener)
-          @bridge = Remote::Bridge.handshake(**opts)
+          desired_capabilities = opts.delete(:desired_capabilities)
+
+          @bridge = Remote::Bridge.new(opts)
           @bridge.extend Bridge
+          @bridge.create_session(desired_capabilities)
 
           super(@bridge, listener: listener)
         end
@@ -66,58 +68,29 @@ module Selenium
           caps = opts.delete(:desired_capabilities) { Remote::Capabilities.chrome }
           options = opts.delete(:options) { Options.new }
 
-          args = opts.delete(:args) || opts.delete(:switches)
-          if args
-            WebDriver.logger.deprecate ':args or :switches', 'Selenium::WebDriver::Chrome::Options#add_argument'
-            raise ArgumentError, ':args must be an Array of Strings' unless args.is_a? Array
-
-            args.each { |arg| options.add_argument(arg.to_s) }
-          end
-
           profile = opts.delete(:profile)
           if profile
-            WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Driver#new with `:profile` parameter',
-                                       'Selenium::WebDriver::Chrome::Options#profile or Options#add_option'
-
             profile = profile.as_json
 
-            if options.args.none?(&/user-data-dir/.method(:match?))
-              options.add_argument("--user-data-dir=#{profile['directory']}")
-            end
+            options.add_argument("--user-data-dir=#{profile[:directory]}") if options.args.none?(&/user-data-dir/.method(:match?))
 
-            if profile['extensions']
-              WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Profile#extensions',
+            if profile[:extensions]
+              WebDriver.logger.deprecate 'Using Selenium::WebDriver::Chrome::Profile#extensions',
                                          'Selenium::WebDriver::Chrome::Options#add_extension'
-              profile['extensions'].each do |extension|
+              profile[:extensions].each do |extension|
                 options.add_encoded_extension(extension)
               end
             end
           end
 
-          if opts.key?(:detach)
-            WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Driver#new with `:detach` parameter',
-                                       'Selenium::WebDriver::Chrome::Options#new or Options#add_option'
-            options.add_option(:detach, opts.delete(:detach))
-          end
-
-          prefs = opts.delete(:prefs)
-          if prefs
-            WebDriver.logger.deprecate ':prefs', 'Selenium::WebDriver::Chrome::Options#add_preference'
-            prefs.each do |key, value|
-              options.add_preference(key, value)
-            end
-          end
+          detach = opts.delete(:detach)
+          options.add_option(:detach, true) if detach
 
           options = options.as_json
           caps.merge!(options) unless options[Options::KEY].empty?
 
-          if opts.key?(:proxy) || opts.key?('proxy')
-            WebDriver.logger.deprecate 'Selenium::WebDriver::Chrome::Driver#new with `:proxy` parameter',
-                                       'Selenium::WebDriver::Chrome::Capabilities#proxy='
-
-            caps[:proxy] = opts.delete(:proxy) if opts.key?(:proxy)
-            caps[:proxy] ||= opts.delete('proxy') if opts.key?('proxy')
-          end
+          caps[:proxy] = opts.delete(:proxy) if opts.key?(:proxy)
+          caps[:proxy] ||= opts.delete('proxy') if opts.key?('proxy')
 
           caps
         end

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

@@ -20,9 +20,9 @@
 module Selenium
   module WebDriver
     module Chrome
-      class Options < WebDriver::Common::Options
+      class Options
         attr_reader :args, :prefs, :options, :emulation, :extensions, :encoded_extensions
-        attr_accessor :binary, :profile, :detach
+        attr_accessor :binary
 
         KEY = 'goog:chromeOptions'
 
@@ -49,8 +49,6 @@ module Selenium
           @extensions = opts.delete(:extensions) || []
           @options = opts.delete(:options) || {}
           @emulation = opts.delete(:emulation) || {}
-          @detach = opts.delete(:detach)
-          @profile = opts.delete(:profile)
           @encoded_extensions = []
         end
 
@@ -172,7 +170,6 @@ module Selenium
             File.open(crx_path, 'rb') { |crx_file| Base64.strict_encode64 crx_file.read }
           end
           extensions.concat(@encoded_extensions)
-          add_argument("--user-data-dir=#{@profile[:directory]}") if @profile
 
           opts = @options
           opts[:binary] = @binary if @binary
@@ -180,9 +177,8 @@ module Selenium
           opts[:extensions] = extensions if extensions.any?
           opts[:mobileEmulation] = @emulation unless @emulation.empty?
           opts[:prefs] = @prefs unless @prefs.empty?
-          opts[:detach] = @detach if !@detach.nil? && @detach != false
 
-          {KEY => generate_as_json(opts)}
+          {KEY => opts}
         end
       end # Options
     end # Chrome

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

@@ -77,8 +77,8 @@ module Selenium
 
           extensions.concat(@encoded_extensions)
 
-          opts = {'directory' => directory || layout_on_disk}
-          opts['extensions'] = extensions if extensions.any?
+          opts = {directory: directory || layout_on_disk}
+          opts[:extensions] = extensions if extensions.any?
           opts
         end
 

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

@@ -25,19 +25,14 @@ module Selenium
       #
 
       class Service < WebDriver::Service
-        @default_port = 9515
-        @executable = 'chromedriver'
-        @missing_text = <<~ERROR
+        DEFAULT_PORT = 9515
+        EXECUTABLE = 'chromedriver'
+        MISSING_TEXT = <<~ERROR
           Unable to find chromedriver. Please download the server from
           https://chromedriver.storage.googleapis.com/index.html and place it somewhere on your PATH.
           More info at https://github.com/SeleniumHQ/selenium/wiki/ChromeDriver.
         ERROR
-        @shutdown_supported = true
-
-        def self.driver_path=(path)
-          Platform.assert_executable path if path.is_a?(String)
-          @driver_path = path
-        end
+        SHUTDOWN_SUPPORTED = true
 
         private
 

data/lib/selenium/webdriver/common.rb

@@ -29,9 +29,6 @@ require 'selenium/webdriver/common/port_prober'
 require 'selenium/webdriver/common/zipper'
 require 'selenium/webdriver/common/wait'
 require 'selenium/webdriver/common/alert'
-require 'selenium/webdriver/common/mouse'
-require 'selenium/webdriver/common/keyboard'
-require 'selenium/webdriver/common/touch_screen'
 require 'selenium/webdriver/common/target_locator'
 require 'selenium/webdriver/common/navigation'
 require 'selenium/webdriver/common/timeouts'
@@ -39,13 +36,16 @@ require 'selenium/webdriver/common/window'
 require 'selenium/webdriver/common/logger'
 require 'selenium/webdriver/common/logs'
 require 'selenium/webdriver/common/manager'
-require 'selenium/webdriver/common/w3c_manager'
 require 'selenium/webdriver/common/search_context'
-require 'selenium/webdriver/common/action_builder'
 require 'selenium/webdriver/common/interactions/key_actions'
 require 'selenium/webdriver/common/interactions/pointer_actions'
-require 'selenium/webdriver/common/w3c_action_builder'
-require 'selenium/webdriver/common/touch_action_builder'
+require 'selenium/webdriver/common/interactions/interactions'
+require 'selenium/webdriver/common/interactions/input_device'
+require 'selenium/webdriver/common/interactions/interaction'
+require 'selenium/webdriver/common/interactions/none_input'
+require 'selenium/webdriver/common/interactions/key_input'
+require 'selenium/webdriver/common/interactions/pointer_input'
+require 'selenium/webdriver/common/action_builder'
 require 'selenium/webdriver/common/html5/shared_web_storage'
 require 'selenium/webdriver/common/html5/local_storage'
 require 'selenium/webdriver/common/html5/session_storage'
@@ -55,7 +55,6 @@ require 'selenium/webdriver/common/driver_extensions/has_web_storage'
 require 'selenium/webdriver/common/driver_extensions/downloads_files'
 require 'selenium/webdriver/common/driver_extensions/has_location'
 require 'selenium/webdriver/common/driver_extensions/has_session_id'
-require 'selenium/webdriver/common/driver_extensions/has_touch_screen'
 require 'selenium/webdriver/common/driver_extensions/has_remote_status'
 require 'selenium/webdriver/common/driver_extensions/has_network_conditions'
 require 'selenium/webdriver/common/driver_extensions/has_network_connection'
@@ -63,15 +62,7 @@ require 'selenium/webdriver/common/driver_extensions/has_permissions'
 require 'selenium/webdriver/common/driver_extensions/has_debugger'
 require 'selenium/webdriver/common/driver_extensions/uploads_files'
 require 'selenium/webdriver/common/driver_extensions/has_addons'
-require 'selenium/webdriver/common/interactions/interactions'
-require 'selenium/webdriver/common/interactions/input_device'
-require 'selenium/webdriver/common/interactions/interaction'
-require 'selenium/webdriver/common/interactions/none_input'
-require 'selenium/webdriver/common/interactions/key_input'
-require 'selenium/webdriver/common/interactions/pointer_input'
 require 'selenium/webdriver/common/keys'
-require 'selenium/webdriver/common/bridge_helper'
 require 'selenium/webdriver/common/profile_helper'
-require 'selenium/webdriver/common/options'
 require 'selenium/webdriver/common/driver'
 require 'selenium/webdriver/common/element'

data/lib/selenium/webdriver/common/action_builder.rb

@@ -19,346 +19,194 @@
 
 module Selenium
   module WebDriver
-    #
-    # The ActionBuilder provides the user a way to set up and perform
-    # complex user interactions.
-    #
-    # This class should not be instantiated directly, but is created by Driver#action
-    #
-    # @example
-    #
-    #  driver.action.key_down(:shift).
-    #                click(element).
-    #                click(second_element).
-    #                key_up(:shift).
-    #                drag_and_drop(element, third_element).
-    #                perform
-    #
-
     class ActionBuilder
-      #
-      # @api private
-      #
+      include KeyActions # Actions specific to key inputs
+      include PointerActions # Actions specific to pointer inputs
 
-      def initialize(mouse, keyboard)
-        @devices = {
-          mouse: mouse,
-          keyboard: keyboard
-        }
-
-        @actions = []
-      end
+      attr_reader :devices
 
       #
-      # Performs a modifier key press. Does not release
-      # the modifier key - subsequent interactions may assume it's kept pressed.
-      # Note that the modifier key is never released implicitly - either
-      # #key_up(key) or #send_keys(:null) must be called to release the modifier.
+      # Initialize a W3C Action Builder. Differs from previous by requiring a bridge and allowing asynchronous actions.
+      # The W3C implementation allows asynchronous actions per device. e.g. A key can be pressed at the same time that
+      # the mouse is moving. Keep in mind that pauses must be added for other devices in order to line up the actions
+      # correctly when using asynchronous.
       #
-      # Equivalent to:
-      #   driver.action.click(element).send_keys(key)
-      #   # or
-      #   driver.action.click.send_keys(key)
-      #
-      # @example Press a key
-      #
-      #    driver.action.key_down(:control).perform
-      #
-      # @example Press a key on an element
-      #
-      #    el = driver.find_element(id: "some_id")
-      #    driver.action.key_down(el, :shift).perform
+      # @param [Selenium::WebDriver::Remote::Bridge] bridge the bridge for the current driver instance
+      # @param [Selenium::WebDriver::Interactions::PointerInput] mouse PointerInput for the mouse.
+      # @param [Selenium::WebDriver::Interactions::KeyInput] keyboard KeyInput for the keyboard.
+      # @param [Boolean] async Whether to perform the actions asynchronously per device. Defaults to false for
+      #   backwards compatibility.
+      # @return [ActionBuilder] A self reference.
       #
-      # @overload key_down(key)
-      #   @param [:shift, :alt, :control, :command, :meta] key The modifier key to press
-      # @overload key_down(element, key)
-      #   @param [Element] element An optional element to move to first
-      #   @param [:shift, :alt, :control, :command, :meta] key The modifier key to press
-      # @raise [ArgumentError] if the given key is not a modifier
-      # @return [ActionBuilder] A self reference
 
-      def key_down(*args)
-        @actions << [:mouse, :click, [args.shift]] if args.first.is_a? Element
-
-        @actions << [:keyboard, :press, args]
-        self
+      def initialize(bridge, mouse, keyboard, async = false)
+        # For backwards compatibility, automatically include mouse & keyboard
+        @bridge = bridge
+        @devices = [mouse, keyboard]
+        @async = async
       end
 
       #
-      # Performs a modifier key release.
-      # Releasing a non-depressed modifier key will yield undefined behaviour.
+      # Adds a PointerInput device of the given kind
       #
-      # @example Release a key
+      # @example Add a touch pointer input device
       #
-      #   driver.action.key_up(:shift).perform
+      #    builder = device.action
+      #    builder.add_pointer_input('touch', :touch)
       #
-      # @example Release a key from an element
+      # @param [String] name name for the device
+      # @param [Symbol] kind kind of pointer device to create
+      # @return [Interactions::PointerInput] The pointer input added
       #
-      #   el = driver.find_element(id: "some_id")
-      #   driver.action.key_up(el, :alt).perform
       #
-      # @overload key_up(key)
-      #   @param [:shift, :alt, :control, :command, :meta] key The modifier key to release
-      # @overload key_up(element, key)
-      #   @param [Element] element An optional element to move to first
-      #   @param [:shift, :alt, :control, :command, :meta] key The modifier key to release
-      # @raise [ArgumentError] if the given key is not a modifier
-      # @return [ActionBuilder] A self reference
-      #
-
-      def key_up(*args)
-        @actions << [:mouse, :click, [args.shift]] if args.first.is_a? Element
 
-        @actions << [:keyboard, :release, args]
-        self
+      def add_pointer_input(kind, name)
+        new_input = Interactions.pointer(kind, name: name)
+        add_input(new_input)
+        new_input
       end
 
       #
-      # Sends keys to the active element. This differs from calling
-      # Element#send_keys(keys) on the active element in two ways:
-      #
-      # * The modifier keys included in this call are not released.
-      # * There is no attempt to re-focus the element - so send_keys(:tab) for switching elements should work.
-      #
-      # @example Send the text "help" to an element
-      #
-      #   el = driver.find_element(id: "some_id")
-      #   driver.action.send_keys(el, "help").perform
+      # Adds a KeyInput device
       #
-      # @example Send the text "help" to the currently focused element
+      # @example Add a key input device
       #
-      #   driver.action.send_keys("help").perform
+      #    builder = device.action
+      #    builder.add_key_input('keyboard2')
       #
-      # @overload send_keys(keys)
-      #   @param [Array, Symbol, String] keys The key(s) to press and release
-      # @overload send_keys(element, keys)
-      #   @param [Element] element An optional element to move to first
-      #   @param [Array, Symbol, String] keys The key(s) to press and release
-      # @return [ActionBuilder] A self reference
+      # @param [String] name name for the device
+      # @return [Interactions::KeyInput] The key input added
       #
 
-      def send_keys(*args)
-        @actions << [:mouse, :click, [args.shift]] if args.first.is_a? Element
-
-        @actions << [:keyboard, :send_keys, args]
-        self
+      def add_key_input(name)
+        new_input = Interactions.key(name)
+        add_input(new_input)
+        new_input
       end
 
       #
-      # Clicks (without releasing) in the middle of the given element. This is
-      # equivalent to:
-      #
-      #   driver.action.move_to(element).click_and_hold
-      #
-      # @example Clicking and holding on some element
+      # Retrieves the input device for the given name
       #
-      #    el = driver.find_element(id: "some_id")
-      #    driver.action.click_and_hold(el).perform
-      #
-      # @param [Element] element the element to move to and click.
-      # @return [ActionBuilder] A self reference.
+      # @param [String] name name of the input device
+      # @return [Selenium::WebDriver::Interactions::InputDevice] input device with given name
       #
 
-      def click_and_hold(element = nil)
-        @actions << [:mouse, :down, [element]]
-        self
+      def get_device(name)
+        @devices.find { |device| device.name == name.to_s }
       end
 
       #
-      # Releases the depressed left mouse button at the current mouse location.
+      # Retrieves the current PointerInput devices
       #
-      # @example Releasing an element after clicking and holding it
-      #
-      #    el = driver.find_element(id: "some_id")
-      #    driver.action.click_and_hold(el).release.perform
-      #
-      # @return [ActionBuilder] A self reference.
+      # @return [Array] array of current PointerInput devices
       #
 
-      def release(element = nil)
-        @actions << [:mouse, :up, [element]]
-        self
+      def pointer_inputs
+        @devices.select { |device| device.type == Interactions::POINTER }
       end
 
       #
-      # Clicks in the middle of the given element. Equivalent to:
-      #
-      #   driver.action.move_to(element).click
-      #
-      # When no element is passed, the current mouse position will be clicked.
-      #
-      # @example Clicking on an element
+      # Retrieves the current KeyInput device
       #
-      #    el = driver.find_element(id: "some_id")
-      #    driver.action.click(el).perform
-      #
-      # @example Clicking at the current mouse position
-      #
-      #    driver.action.click.perform
-      #
-      # @param [Selenium::WebDriver::Element] element An optional element to click.
-      # @return [ActionBuilder] A self reference.
+      # @return [Selenium::WebDriver::Interactions::InputDevice] current KeyInput device
       #
 
-      def click(element = nil)
-        @actions << [:mouse, :click, [element]]
-        self
+      def key_inputs
+        @devices.select { |device| device.type == Interactions::KEY }
       end
 
       #
-      # Performs a double-click at middle of the given element. Equivalent to:
-      #
-      #   driver.action.move_to(element).double_click
+      # Creates a pause for the given device of the given duration. If no duration is given, the pause will only wait
+      # for all actions to complete in that tick.
       #
-      # @example Double click an element
+      # @example Send keys to an element
       #
-      #    el = driver.find_element(id: "some_id")
-      #    driver.action.double_click(el).perform
+      #   action_builder = driver.action
+      #   keyboard = action_builder.key_input
+      #   el = driver.find_element(id: "some_id")
+      #   driver.action.click(el).pause(keyboard).pause(keyboard).pause(keyboard).send_keys('keys').perform
       #
-      # @param [Selenium::WebDriver::Element] element An optional element to move to.
+      # @param [InputDevice] device Input device to pause
+      # @param [Float] duration Duration to pause
       # @return [ActionBuilder] A self reference.
       #
 
-      def double_click(element = nil)
-        @actions << [:mouse, :double_click, [element]]
+      def pause(device, duration = nil)
+        device.create_pause(duration)
         self
       end
 
       #
-      # Moves the mouse to the middle of the given element. The element is scrolled into
-      # view and its location is calculated using getBoundingClientRect.  Then the
-      # mouse is moved to optional offset coordinates from the element.
-      #
-      # Note that when using offsets, both coordinates need to be passed.
-      #
-      # @example Scroll element into view and move the mouse to it
+      # Creates multiple pauses for the given device of the given duration.
       #
-      #   el = driver.find_element(id: "some_id")
-      #   driver.action.move_to(el).perform
-      #
-      # @example
+      # @example Send keys to an element
       #
+      #   action_builder = driver.action
+      #   keyboard = action_builder.key_input
       #   el = driver.find_element(id: "some_id")
-      #   driver.action.move_to(el, 100, 100).perform
+      #   driver.action.click(el).pauses(keyboard, 3).send_keys('keys').perform
       #
-      # @param [Selenium::WebDriver::Element] element to move to.
-      # @param [Integer] right_by Optional offset from the top-left corner. A negative value means
-      #   coordinates right from the element.
-      # @param [Integer] down_by Optional offset from the top-left corner. A negative value means
-      #   coordinates above the element.
+      # @param [InputDevice] device Input device to pause
+      # @param [Integer] number of pauses to add for the device
+      # @param [Float] duration Duration to pause
       # @return [ActionBuilder] A self reference.
       #
 
-      def move_to(element, right_by = nil, down_by = nil)
-        @actions << if right_by && down_by
-                      [:mouse, :move_to, [element, Integer(right_by), Integer(down_by)]]
-                    else
-                      [:mouse, :move_to, [element]]
-                    end
-
+      def pauses(device, number, duration = nil)
+        number.times { device.create_pause(duration) }
         self
       end
 
       #
-      # Moves the mouse from its current position (or 0,0) by the given offset.
-      # If the coordinates provided are outside the viewport (the mouse will
-      # end up outside the browser window) then the viewport is scrolled to
-      # match.
-      #
-      # @example Move the mouse to a certain offset from its current position
-      #
-      #    driver.action.move_by(100, 100).perform
-      #
-      # @param [Integer] right_by horizontal offset. A negative value means moving the
-      #   mouse left.
-      # @param [Integer] down_by vertical offset. A negative value means moving the mouse
-      #   up.
-      # @return [ActionBuilder] A self reference.
-      # @raise [MoveTargetOutOfBoundsError] if the provided offset is outside
-      #   the document's boundaries.
+      # Executes the actions added to the builder.
       #
 
-      def move_by(right_by, down_by)
-        @actions << [:mouse, :move_by, [Integer(right_by), Integer(down_by)]]
-        self
+      def perform
+        @bridge.send_actions @devices.map(&:encode).compact
+        clear_all_actions
+        nil
       end
 
       #
-      # Performs a context-click at middle of the given element. First performs
-      # a move_to to the location of the element.
-      #
-      # @example Context-click at middle of given element
-      #
-      #   el = driver.find_element(id: "some_id")
-      #   driver.action.context_click(el).perform
-      #
-      # @param [Selenium::WebDriver::Element] element An element to context click.
-      # @return [ActionBuilder] A self reference.
+      # Clears all actions from the builder.
       #
 
-      def context_click(element = nil)
-        @actions << [:mouse, :context_click, [element]]
-        self
+      def clear_all_actions
+        @devices.each(&:clear_actions)
       end
 
       #
-      # A convenience method that performs click-and-hold at the location of the
-      # source element, moves to the location of the target element, then
-      # releases the mouse.
-      #
-      # @example Drag and drop one element onto another
-      #
-      #   el1 = driver.find_element(id: "some_id1")
-      #   el2 = driver.find_element(id: "some_id2")
-      #   driver.action.drag_and_drop(el1, el2).perform
-      #
-      # @param [Selenium::WebDriver::Element] source element to emulate button down at.
-      # @param [Selenium::WebDriver::Element] target element to move to and release the
-      #   mouse at.
-      # @return [ActionBuilder] A self reference.
+      # Releases all action states from the browser.
       #
 
-      def drag_and_drop(source, target)
-        click_and_hold source
-        move_to        target
-        release
-
-        self
+      def release_actions
+        @bridge.release_actions
       end
 
+      private
+
       #
-      # A convenience method that performs click-and-hold at the location of
-      # the source element, moves by a given offset, then releases the mouse.
-      #
-      # @example Drag and drop an element by offset
+      # Adds pauses for all devices but the given devices
       #
-      #   el = driver.find_element(id: "some_id1")
-      #   driver.action.drag_and_drop_by(el, 100, 100).perform
-      #
-      # @param [Selenium::WebDriver::Element] source Element to emulate button down at.
-      # @param [Integer] right_by horizontal move offset.
-      # @param [Integer] down_by vertical move offset.
-      # @return [ActionBuilder] A self reference.
+      # @param [Array[InputDevice]] action_devices Array of Input Devices performing an action in this tick.
       #
 
-      def drag_and_drop_by(source, right_by, down_by)
-        click_and_hold source
-        move_by        right_by, down_by
-        release
+      def tick(*action_devices)
+        return if @async
 
-        self
+        @devices.each { |device| device.create_pause unless action_devices.include? device }
       end
 
       #
-      # Executes the actions added to the builder.
+      # Adds an InputDevice
       #
 
-      def perform
-        @actions.each do |receiver, method, args|
-          @devices.fetch(receiver).__send__(method, *args)
+      def add_input(device)
+        unless @async
+          max_device = @devices.max { |a, b| a.actions.length <=> b.actions.length }
+          pauses(device, max_device.actions.length)
         end
-
-        nil
+        @devices << device
       end
     end # ActionBuilder
   end # WebDriver