selenium-webdriver 4.0.0.alpha1 → 4.0.0.alpha2

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

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

@@ -1,45 +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 W3CManager < Manager
-
-      #
-      # Get the cookie with the given name
-      #
-      # @param [String] name the name of the cookie
-      # @return [Hash, nil] the cookie, or nil if it wasn't found.
-      #
-
-      def cookie_named(name)
-        convert_cookie(@bridge.cookie(name))
-      end
-
-      #
-      # Delete all cookies
-      #
-
-      def delete_all_cookies
-        @bridge.delete_all_cookies
-      end
-
-    end # WC3Options
-  end # WebDriver
-end # Selenium