tdiary 5.2.2 → 5.2.3

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.4.0/lib/selenium/webdriver/common/driver.rb

@@ -0,0 +1,364 @@
+# 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
+    #
+    # The main class through which you control the browser.
+    #
+    # @see SearchContext
+    # @see Navigation
+    # @see TargetLocator
+    # @see Options
+    #
+
+    class Driver
+      include SearchContext
+      include TakesScreenshot
+
+      class << self
+        #
+        # @api private
+        #
+        # @see Selenium::WebDriver.for
+        #
+        # @return [Driver]
+        #
+
+        def for(browser, opts = {})
+          case browser
+          when :chrome
+            Chrome::Driver.new(**opts)
+          when :internet_explorer, :ie
+            IE::Driver.new(**opts)
+          when :safari
+            Safari::Driver.new(**opts)
+          when :firefox, :ff
+            Firefox::Driver.new(**opts)
+          when :edge
+            Edge::Driver.new(**opts)
+          when :remote
+            Remote::Driver.new(**opts)
+          else
+            raise ArgumentError, "unknown driver: #{browser.inspect}"
+          end
+        end
+      end
+
+      #
+      # A new Driver instance with the given bridge.
+      # End users should use Selenium::WebDriver.for instead of using this directly.
+      #
+      # @api private
+      #
+
+      def initialize(bridge: nil, listener: nil, **opts)
+        @service = nil
+        @devtools = nil
+        bridge ||= create_bridge(**opts)
+        add_extensions(bridge.browser)
+        @bridge = listener ? Support::EventFiringBridge.new(bridge, listener) : bridge
+      end
+
+      def inspect
+        format '#<%<class>s:0x%<hash>x browser=%<browser>s>', class: self.class, hash: hash * 2,
+                                                              browser: bridge.browser.inspect
+      end
+
+      #
+      # information about whether a remote end is in a state in which it can create new sessions,
+      # and may include additional meta information.
+      #
+      # @return [Hash]
+      #
+      def status
+        @bridge.status
+      end
+
+      #
+      # @return [Navigation]
+      # @see Navigation
+      #
+
+      def navigate
+        @navigate ||= WebDriver::Navigation.new(bridge)
+      end
+
+      #
+      # @return [TargetLocator]
+      # @see TargetLocator
+      #
+
+      def switch_to
+        @switch_to ||= WebDriver::TargetLocator.new(bridge)
+      end
+
+      #
+      # @return [Manager]
+      # @see Manager
+      #
+
+      def manage
+        bridge.manage
+      end
+
+      #
+      # @return [ActionBuilder]
+      # @see ActionBuilder
+      #
+
+      def action(**opts)
+        bridge.action(**opts)
+      end
+
+      def mouse
+        bridge.mouse
+      end
+
+      def keyboard
+        bridge.keyboard
+      end
+
+      #
+      # Opens the specified URL in the browser.
+      #
+
+      def get(url)
+        navigate.to(url)
+      end
+
+      #
+      # Get the URL of the current page
+      #
+      # @return [String]
+      #
+
+      def current_url
+        bridge.url
+      end
+
+      #
+      # Get the title of the current page
+      #
+      # @return [String]
+      #
+
+      def title
+        bridge.title
+      end
+
+      #
+      # Get the source of the current page
+      #
+      # @return [String]
+      #
+
+      def page_source
+        bridge.page_source
+      end
+
+      #
+      # Quit the browser
+      #
+
+      def quit
+        bridge.quit
+      ensure
+        @service&.stop
+        @devtools&.close
+      end
+
+      #
+      # Close the current window, or the browser if no windows are left.
+      #
+
+      def close
+        bridge.close
+      end
+
+      #
+      # Get the window handles of open browser windows.
+      #
+      # @return [Array]
+      # @see TargetLocator#window
+      #
+
+      def window_handles
+        bridge.window_handles
+      end
+
+      #
+      # Get the current window handle
+      #
+      # @return [String]
+      #
+
+      def window_handle
+        bridge.window_handle
+      end
+
+      #
+      # Execute the given JavaScript
+      #
+      # @param [String] script
+      #   JavaScript source to execute
+      # @param [WebDriver::Element, Integer, Float, Boolean, NilClass, String, Array] args
+      #   Arguments will be available in the given script in the 'arguments' pseudo-array.
+      #
+      # @return [WebDriver::Element,Integer,Float,Boolean,NilClass,String,Array]
+      #   The value returned from the script.
+      #
+
+      def execute_script(script, *args)
+        bridge.execute_script(script, *args)
+      end
+
+      # Execute an asynchronous piece of JavaScript in the context of the
+      # currently selected frame or window. Unlike executing
+      # execute_script (synchronous JavaScript), scripts
+      # executed with this method must explicitly signal they are finished by
+      # invoking the provided callback. This callback is always injected into the
+      # executed function as the last argument.
+      #
+      # @param [String] script
+      #   JavaScript source to execute
+      # @param [WebDriver::Element,Integer, Float, Boolean, NilClass, String, Array] args
+      #   Arguments to the script. May be empty.
+      #
+      # @return [WebDriver::Element,Integer,Float,Boolean,NilClass,String,Array]
+      #
+
+      def execute_async_script(script, *args)
+        bridge.execute_async_script(script, *args)
+      end
+
+      #
+      # @return [VirtualAuthenticator]
+      # @see VirtualAuthenticator
+      #
+
+      def add_virtual_authenticator(options)
+        bridge.add_virtual_authenticator(options)
+      end
+
+      #-------------------------------- sugar  --------------------------------
+
+      #
+      #   driver.first(id: 'foo')
+      #
+
+      alias_method :first, :find_element
+
+      #
+      #   driver.all(class: 'bar') #=> [#<WebDriver::Element:0x1011c3b88, ...]
+      #
+
+      alias_method :all, :find_elements
+
+      #
+      #   driver.script('function() { ... };')
+      #
+
+      alias_method :script, :execute_script
+
+      # Get the first element matching the given selector. If given a
+      # String or Symbol, it will be used as the id of the element.
+      #
+      # @param  [String,Hash] sel id or selector
+      # @return [WebDriver::Element]
+      #
+      # Examples:
+      #
+      #   driver['someElementId']    #=> #<WebDriver::Element:0x1011c3b88>
+      #   driver[:tag_name => 'div'] #=> #<WebDriver::Element:0x1011c3b88>
+      #
+
+      def [](sel)
+        sel = {id: sel} if sel.is_a?(String) || sel.is_a?(Symbol)
+
+        find_element sel
+      end
+
+      def browser
+        bridge&.browser
+      end
+
+      def capabilities
+        bridge.capabilities
+      end
+
+      #
+      # @api private
+      # @see SearchContext
+      #
+
+      def ref
+        [:driver, nil]
+      end
+
+      private
+
+      attr_reader :bridge
+
+      def create_bridge(capabilities: nil, options: nil, url: nil, service: nil, http_client: nil)
+        Remote::Bridge.new(http_client: http_client,
+                           url: url || service_url(service)).tap do |bridge|
+          generated_caps = options ? options.as_json : generate_capabilities(capabilities)
+          bridge.create_session(generated_caps)
+        end
+      end
+
+      def generate_capabilities(capabilities)
+        Array(capabilities).map { |cap|
+          if cap.is_a? Symbol
+            cap = Remote::Capabilities.send(cap)
+          elsif !cap.respond_to? :as_json
+            msg = ":capabilities parameter only accepts objects responding to #as_json which #{cap.class} does not"
+            raise ArgumentError, msg
+          end
+          cap.as_json
+        }.inject(:merge) || Remote::Capabilities.send(browser || :new)
+      end
+
+      def service_url(service)
+        service ||= Service.send(browser)
+        @service = service.launch
+        @service.uri
+      end
+
+      def screenshot
+        bridge.screenshot
+      end
+
+      def add_extensions(browser)
+        extensions = case browser
+                     when :chrome, :msedge
+                       Chrome::Driver::EXTENSIONS
+                     when :firefox
+                       Firefox::Driver::EXTENSIONS
+                     when :safari, :safari_technology_preview
+                       Safari::Driver::EXTENSIONS
+                     else
+                       []
+                     end
+        extensions.each { |extension| extend extension }
+      end
+    end # Driver
+  end # WebDriver
+end # Selenium

data/vendor/bundle/ruby/3.1.0/gems/selenium-webdriver-4.4.0/lib/selenium/webdriver/common/driver_extensions/has_network_interception.rb

@@ -0,0 +1,71 @@
+# 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 DriverExtensions
+      module HasNetworkInterception
+
+        #
+        # Intercepts requests coming from browser allowing
+        # to either pass them through like proxy or provide
+        # a stubbed response instead.
+        #
+        # @example Log requests and pass through
+        #   driver.intercept do |request, &continue|
+        #     puts "#{request.method} #{request.url}"
+        #     continue.call(request)
+        #   end
+        #
+        # @example Stub requests for images
+        #   driver.intercept do |request, &continue|
+        #     if request.url.match?(/\.png$/)
+        #       request.url = 'https://upload.wikimedia.org/wikipedia/commons/d/d5/Selenium_Logo.png'
+        #     end
+        #     continue.call(request)
+        #   end
+        #
+        # @example Log responses and pass through
+        #   driver.intercept do |request, &continue|
+        #     continue.call(request) do |response|
+        #       puts "#{response.code} #{response.body}"
+        #     end
+        #   end
+        #
+        # @example Mutate specific response
+        #   driver.intercept do |request, &continue|
+        #     continue.call(request) do |response|
+        #       response.body << 'Added by Selenium!' if request.url.include?('/myurl')
+        #     end
+        #   end
+        #
+        # @param [Proc] block which is called when request is intercepted
+        # @yieldparam [DevTools::Request] request
+        # @yieldparam [Proc] continue block which proceeds with the request and optionally yields response
+        #
+
+        def intercept(&block)
+          @interceptor ||= DevTools::NetworkInterceptor.new(devtools)
+          @interceptor.intercept(&block)
+        end
+
+      end # HasNetworkInterception
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium