selenium-webdriver 3.142.7 → 4.16.0

data/lib/selenium/webdriver/common/driver_extensions/takes_screenshot.rb

@@ -1,64 +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
-    #
-
-    module DriverExtensions
-      module TakesScreenshot
-        #
-        # Save a PNG screenshot to the given path
-        #
-        # @api public
-        #
-
-        def save_screenshot(png_path)
-          extension = File.extname(png_path).downcase
-          if extension != '.png'
-            WebDriver.logger.warn "name used for saved screenshot does not match file type. "\
-                                  "It should end with .png extension"
-          end
-          File.open(png_path, 'wb') { |f| f << screenshot_as(:png) }
-        end
-
-        #
-        # Return a PNG screenshot in the given format as a string
-        #
-        # @param [:base64, :png] format
-        # @return String screenshot
-        #
-        # @api public
-
-        def screenshot_as(format)
-          case format
-          when :base64
-            bridge.screenshot
-          when :png
-            bridge.screenshot.unpack('m')[0]
-          else
-            raise Error::UnsupportedOperationError, "unsupported format: #{format.inspect}"
-          end
-        end
-      end # TakesScreenshot
-    end # DriverExtensions
-  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

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

@@ -1,76 +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
-    module Edge
-      module Bridge
-
-        def commands(command)
-          unsupported = %i[execute_script execute_async_script submit_element double_click
-                           mouse_down mouse_up mouse_move_to click
-                           send_keys_to_active_element get_window_handles get_current_window_handle
-                           get_window_size set_window_size get_window_position set_window_position
-                           maximize_window get_alert_text accept_alert dismiss_alert]
-          if unsupported.include? command
-            Remote::OSS::Bridge::COMMANDS[command]
-          else
-            super
-          end
-        end
-
-        def send_keys_to_active_element(key)
-          execute :send_keys_to_active_element, {}, {value: key}
-        end
-
-        def window_handle
-          execute :get_current_window_handle
-        end
-
-        def window_size(handle = :current)
-          data = execute :get_window_size, window_handle: handle
-
-          Dimension.new data['width'], data['height']
-        end
-
-        def resize_window(width, height, handle = :current)
-          execute :set_window_size, {window_handle: handle},
-                  {width: width,
-                   height: height}
-        end
-
-        def window_position(handle = :current)
-          data = execute :get_window_position, window_handle: handle
-
-          Point.new data['x'], data['y']
-        end
-
-        def reposition_window(x, y, handle = :current)
-          execute :set_window_position, {window_handle: handle},
-                  {x: x, y: y}
-        end
-
-        def maximize_window(handle = :current)
-          execute :maximize_window, window_handle: handle
-        end
-
-      end # Bridge
-    end # Edge
-  end # WebDriver
-end # Selenium