selenium-webdriver 4.0.0.alpha1 → 4.0.0.alpha6

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

@@ -1,82 +0,0 @@
-# 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
-    #
-    # Shared across bridges
-    #
-    # @api private
-    #
-
-    module BridgeHelper
-      def unwrap_script_result(arg)
-        case arg
-        when Array
-          arg.map { |e| unwrap_script_result(e) }
-        when Hash
-          element_id = element_id_from(arg)
-          return Element.new(self, element_id) if element_id
-
-          arg.each { |k, v| arg[k] = unwrap_script_result(v) }
-        else
-          arg
-        end
-      end
-
-      def element_id_from(id)
-        id['ELEMENT'] || id['element-6066-11e4-a52e-4f735466cecf']
-      end
-
-      def parse_cookie_string(str)
-        result = {
-          'name' => '',
-          'value' => '',
-          'domain' => '',
-          'path' => '',
-          'expires' => '',
-          'secure' => false
-        }
-
-        str.split(';').each do |attribute|
-          if attribute.include? '='
-            key, value = attribute.strip.split('=', 2)
-            if result['name'].empty?
-              result['name']  = key
-              result['value'] = value
-            elsif key == 'domain' && value.strip =~ /^\.(.+)/
-              result['domain'] = Regexp.last_match(1)
-            elsif key && value
-              result[key] = value
-            end
-          elsif attribute == 'secure'
-            result['secure'] = true
-          end
-
-          unless [nil, '', '0'].include?(result['expires'])
-            # firefox stores expiry as number of seconds
-            result['expires'] = Time.at(result['expires'].to_i)
-          end
-        end
-
-        result
-      end
-    end # BridgeHelper
-  end # WebDriver
-end # Selenium

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

@@ -1,70 +0,0 @@
-# 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
-    #
-    # @api private
-    # @see ActionBuilder
-
-    class Keyboard
-      def initialize(bridge)
-        @bridge = bridge
-      end
-
-      def send_keys(*keys)
-        @bridge.send_keys_to_active_element Keys.encode(keys)
-      end
-
-      #
-      # Press a modifier key
-      #
-      # @see Selenium::WebDriver::Keys
-      #
-
-      def press(key)
-        assert_modifier key
-
-        @bridge.send_keys_to_active_element Keys.encode([key])
-      end
-
-      #
-      # Release a modifier key
-      #
-      # @see Selenium::WebDriver::Keys
-      #
-
-      def release(key)
-        assert_modifier key
-
-        @bridge.send_keys_to_active_element Keys.encode([key])
-      end
-
-      private
-
-      MODIFIERS = %i[control shift alt command meta].freeze
-
-      def assert_modifier(key)
-        return if MODIFIERS.include? key
-
-        raise ArgumentError, "#{key.inspect} is not a modifier key, expected one of #{MODIFIERS.inspect}"
-      end
-    end # Keyboard
-  end # WebDriver
-end # Selenium

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

@@ -1,89 +0,0 @@
-# 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
-    #
-    # @api private
-    # @see ActionBuilder
-    #
-
-    class Mouse
-      def initialize(bridge)
-        @bridge = bridge
-      end
-
-      def click(element = nil)
-        move_if_needed element
-        @bridge.click
-      end
-
-      def double_click(element = nil)
-        move_if_needed element
-        @bridge.double_click
-      end
-
-      def context_click(element = nil)
-        move_if_needed element
-        @bridge.context_click
-      end
-
-      def down(element = nil)
-        move_if_needed element
-        @bridge.mouse_down
-      end
-
-      def up(element = nil)
-        move_if_needed element
-        @bridge.mouse_up
-      end
-
-      #
-      # Move the mouse.
-      #
-      # Examples:
-      #
-      #   driver.mouse.move_to(element)
-      #   driver.mouse.move_to(element, 5, 5)
-      #
-
-      def move_to(element, right_by = nil, down_by = nil)
-        assert_element element
-
-        @bridge.mouse_move_to element.ref, right_by, down_by
-      end
-
-      def move_by(right_by, down_by)
-        @bridge.mouse_move_to nil, Integer(right_by), Integer(down_by)
-      end
-
-      private
-
-      def move_if_needed(element)
-        move_to element if element
-      end
-
-      def assert_element(element)
-        return if element.is_a? Element
-
-        raise TypeError, "expected #{Element}, got #{element.inspect}:#{element.class}"
-      end
-    end # Mouse
-  end # WebDriver
-end # Selenium

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

@@ -1,78 +0,0 @@
-# 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
-    class TouchActionBuilder < ActionBuilder
-      #
-      # @api private
-      #
-
-      def initialize(mouse, keyboard, touch_screen)
-        WebDriver.logger.deprecate(self.class.name)
-        super(mouse, keyboard)
-        @devices[:touch_screen] = touch_screen
-      end
-
-      def scroll(*args)
-        raise ArgumentError, "wrong number of arguments, expected 2..3, got #{args.size}" unless [2, 3].include? args.size
-
-        @actions << [:touch_screen, :scroll, args]
-        self
-      end
-
-      def flick(*args)
-        raise ArgumentError, "wrong number of arguments, expected 2 or 4, got #{args.size}" unless [2, 4].include? args.size
-
-        @actions << [:touch_screen, :flick, args]
-        self
-      end
-
-      def single_tap(element)
-        @actions << [:touch_screen, :single_tap, [element]]
-        self
-      end
-
-      def double_tap(element)
-        @actions << [:touch_screen, :double_tap, [element]]
-        self
-      end
-
-      def long_press(element)
-        @actions << [:touch_screen, :long_press, [element]]
-        self
-      end
-
-      def down(x, y = nil)
-        @actions << [:touch_screen, :down, [x, y]]
-        self
-      end
-
-      def up(x, y = nil)
-        @actions << [:touch_screen, :up, [x, y]]
-        self
-      end
-
-      def move(x, y = nil)
-        @actions << [:touch_screen, :move, [x, y]]
-        self
-      end
-    end # TouchActionBuilder
-  end # WebDriver
-end # Selenium

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

@@ -1,123 +0,0 @@
-# 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
-    class TouchScreen
-      FLICK_SPEED = {normal: 0, fast: 1}.freeze
-
-      #
-      # @api private
-      #
-
-      def initialize(bridge)
-        @bridge = bridge
-      end
-
-      def single_tap(element)
-        assert_element element
-        @bridge.touch_single_tap element.ref
-      end
-
-      def double_tap(element)
-        assert_element element
-        @bridge.touch_double_tap element.ref
-      end
-
-      def long_press(element)
-        assert_element element
-        @bridge.touch_long_press element.ref
-      end
-
-      def down(x, y = nil)
-        x, y = coords_from x, y
-        @bridge.touch_down x, y
-      end
-
-      def up(x, y = nil)
-        x, y = coords_from x, y
-        @bridge.touch_up x, y
-      end
-
-      def move(x, y = nil)
-        x, y = coords_from x, y
-        @bridge.touch_move x, y
-      end
-
-      def scroll(*args)
-        case args.size
-        when 2
-          x_offset, y_offset = args
-          @bridge.touch_scroll nil, Integer(x_offset), Integer(y_offset)
-        when 3
-          element, x_offset, y_offset = args
-          assert_element element
-          @bridge.touch_scroll element.ref, Integer(x_offset), Integer(y_offset)
-        else
-          raise ArgumentError, "wrong number of arguments, expected 2..3, got #{args.size}"
-        end
-      end
-
-      def flick(*args)
-        case args.size
-        when 2
-          x_speed, y_speed = args
-          @bridge.touch_flick Integer(x_speed), Integer(y_speed)
-        when 4
-          element, xoffset, yoffset, speed = args
-
-          assert_element element
-
-          if (speed.is_a?(String) || speed.is_a?(Symbol)) && FLICK_SPEED.key?(speed.to_sym)
-            WebDriver.logger.deprecate "Passing #{speed.inspect} speed",
-                                       "Integer or Selenium::WebDriver::TouchScreen::FLICK_SPEED[:#{speed}]"
-            speed = FLICK_SPEED[speed.to_sym]
-          end
-
-          @bridge.touch_element_flick element.ref, Integer(xoffset), Integer(yoffset), Integer(speed)
-        else
-          raise ArgumentError, "wrong number of arguments, expected 2 or 4, got #{args.size}"
-        end
-      end
-
-      private
-
-      def coords_from(x, y)
-        if y.nil?
-          point = x
-
-          unless point.respond_to?(:x) && point.respond_to?(:y)
-            raise ArgumentError, "expected #{point.inspect} to respond to :x and :y"
-          end
-
-          x = point.x
-          y = point.y
-        end
-
-        [Integer(x), Integer(y)]
-      end
-
-      def assert_element(element)
-        return if element.is_a? Element
-
-        raise TypeError, "expected #{Element}, got #{element.inspect}:#{element.class}"
-      end
-    end # TouchScreen
-  end # WebDriver
-end # Selenium

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

@@ -1,212 +0,0 @@
-# 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
-    class W3CActionBuilder
-      include KeyActions # Actions specific to key inputs
-      include PointerActions # Actions specific to pointer inputs
-      attr_reader :devices
-
-      #
-      # 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.
-      #
-      # @param [Selenium::WebDriver::Remote::W3CBridge] 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 [W3CActionBuilder] A self reference.
-      #
-
-      def initialize(bridge, mouse, keyboard, async = false)
-        # For backwards compatibility, automatically include mouse & keyboard
-        @bridge = bridge
-        @devices = [mouse, keyboard]
-        @async = async
-      end
-
-      #
-      # Adds a PointerInput device of the given kind
-      #
-      # @example Add a touch pointer input device
-      #
-      #    builder = device.action
-      #    builder.add_pointer_input('touch', :touch)
-      #
-      # @param [String] name name for the device
-      # @param [Symbol] kind kind of pointer device to create
-      # @return [Interactions::PointerInput] The pointer input added
-      #
-      #
-
-      def add_pointer_input(kind, name)
-        new_input = Interactions.pointer(kind, name: name)
-        add_input(new_input)
-        new_input
-      end
-
-      #
-      # Adds a KeyInput device
-      #
-      # @example Add a key input device
-      #
-      #    builder = device.action
-      #    builder.add_key_input('keyboard2')
-      #
-      # @param [String] name name for the device
-      # @return [Interactions::KeyInput] The key input added
-      #
-
-      def add_key_input(name)
-        new_input = Interactions.key(name)
-        add_input(new_input)
-        new_input
-      end
-
-      #
-      # Retrieves the input device for the given name
-      #
-      # @param [String] name name of the input device
-      # @return [Selenium::WebDriver::Interactions::InputDevice] input device with given name
-      #
-
-      def get_device(name)
-        @devices.find { |device| device.name == name.to_s }
-      end
-
-      #
-      # Retrieves the current PointerInput devices
-      #
-      # @return [Array] array of current PointerInput devices
-      #
-
-      def pointer_inputs
-        @devices.select { |device| device.type == Interactions::POINTER }
-      end
-
-      #
-      # Retrieves the current KeyInput device
-      #
-      # @return [Selenium::WebDriver::Interactions::InputDevice] current KeyInput device
-      #
-
-      def key_inputs
-        @devices.select { |device| device.type == Interactions::KEY }
-      end
-
-      #
-      # 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 Send keys to an element
-      #
-      #   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 [InputDevice] device Input device to pause
-      # @param [Float] duration Duration to pause
-      # @return [W3CActionBuilder] A self reference.
-      #
-
-      def pause(device, duration = nil)
-        device.create_pause(duration)
-        self
-      end
-
-      #
-      # Creates multiple pauses for the given device of the given duration.
-      #
-      # @example Send keys to an element
-      #
-      #   action_builder = driver.action
-      #   keyboard = action_builder.key_input
-      #   el = driver.find_element(id: "some_id")
-      #   driver.action.click(el).pauses(keyboard, 3).send_keys('keys').perform
-      #
-      # @param [InputDevice] device Input device to pause
-      # @param [Integer] number of pauses to add for the device
-      # @param [Float] duration Duration to pause
-      # @return [W3CActionBuilder] A self reference.
-      #
-
-      def pauses(device, number, duration = nil)
-        number.times { device.create_pause(duration) }
-        self
-      end
-
-      #
-      # Executes the actions added to the builder.
-      #
-
-      def perform
-        @bridge.send_actions @devices.map(&:encode).compact
-        clear_all_actions
-        nil
-      end
-
-      #
-      # Clears all actions from the builder.
-      #
-
-      def clear_all_actions
-        @devices.each(&:clear_actions)
-      end
-
-      #
-      # Releases all action states from the browser.
-      #
-
-      def release_actions
-        @bridge.release_actions
-      end
-
-      private
-
-      #
-      # Adds pauses for all devices but the given devices
-      #
-      # @param [Array[InputDevice]] action_devices Array of Input Devices performing an action in this tick.
-      #
-
-      def tick(*action_devices)
-        return if @async
-
-        @devices.each { |device| device.create_pause unless action_devices.include? device }
-      end
-
-      #
-      # Adds an InputDevice
-      #
-
-      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
-        @devices << device
-      end
-    end # W3CActionBuilder
-  end # WebDriver
-end # Selenium