selenium-webdriver 4.0.0.alpha6 → 4.0.0.alpha7

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

@@ -23,6 +23,7 @@ module Selenium
       ELEMENT_KEY = 'element-6066-11e4-a52e-4f735466cecf'
 
       include SearchContext
+      include TakesScreenshot
 
       #
       # Creates a new Element
@@ -327,6 +328,10 @@ module Selenium
 
         tn == 'option' || (tn == 'input' && %w[radio checkbox].include?(type))
       end
+
+      def screenshot
+        bridge.element_screenshot(self)
+      end
     end # Element
   end # WebDriver
 end # Selenium

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

@@ -85,12 +85,12 @@ module Selenium
       private
 
       def generate_as_json(value, camelize_keys: true)
-        if value.respond_to?(:as_json)
-          value.as_json
-        elsif value.is_a?(Hash)
+        if value.is_a?(Hash)
           value.each_with_object({}) do |(key, val), hash|
             hash[convert_json_key(key, camelize: camelize_keys)] = generate_as_json(val, camelize_keys: camelize_keys)
           end
+        elsif value.respond_to?(:as_json)
+          value.as_json
         elsif value.is_a?(Array)
           value.map { |val| generate_as_json(val, camelize_keys: camelize_keys) }
         elsif value.is_a?(Symbol)

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

@@ -95,7 +95,7 @@ module Selenium
       def wsl?
         return false unless linux?
 
-        File.read('/proc/version').include?('Microsoft')
+        File.read('/proc/version').downcase.include?('microsoft')
       rescue Errno::EACCES
         # the file cannot be accessed on Linux on DeX
         false

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

@@ -0,0 +1,63 @@
+# 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 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",
+                                id: :screenshot
+        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
+          screenshot
+        when :png
+          screenshot.unpack1('m')
+        else
+          raise Error::UnsupportedOperationError, "unsupported format: #{format.inspect}"
+        end
+      end
+
+    end # TakesScreenshot
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/devtools.rb

@@ -17,16 +17,20 @@
 # specific language governing permissions and limitations
 # under the License.
 
-Dir["#{__dir__}/devtools/*"].sort.each { |f| require f }
-
 module Selenium
   module WebDriver
     class DevTools
+      autoload :ConsoleEvent, 'selenium/webdriver/devtools/console_event'
+      autoload :ExceptionEvent, 'selenium/webdriver/devtools/exception_event'
+      autoload :MutationEvent, 'selenium/webdriver/devtools/mutation_event'
+
+      SUPPORTED_VERSIONS = [84, 85, 86].freeze
 
-      def initialize(url)
+      def initialize(url:, version:)
         @messages = []
         @uri = URI("http://#{url}")
 
+        load_devtools_version(version)
         process_handshake
         attach_socket_listener
 
@@ -41,6 +45,7 @@ module Selenium
       def send_cmd(method, **params)
         id = next_id
         data = JSON.generate(id: id, method: method, params: params.reject { |_, v| v.nil? })
+        WebDriver.logger.debug "DevTools -> #{data}"
 
         out_frame = WebSocket::Frame::Outgoing::Client.new(version: ws.version, data: data, type: 'text')
         socket.write(out_frame.to_s)
@@ -56,6 +61,14 @@ module Selenium
 
       private
 
+      def load_devtools_version(version)
+        closest_version = SUPPORTED_VERSIONS.min_by { |v| (version - v).abs }
+        WebDriver.logger.info("Loading DevTools::V#{closest_version} for #{version}.")
+        Dir["#{__dir__}/devtools/v#{closest_version}/*"].sort.each do |f|
+          require f
+        end
+      end
+
       def process_handshake
         socket.print(ws.to_s)
         ws << socket.readpartial(1024)
@@ -69,10 +82,11 @@ module Selenium
             while (frame = incoming_frame.next)
               message = JSON.parse(frame.to_s)
               @messages << message
+              WebDriver.logger.debug "DevTools <- #{message}"
               next unless message['method']
 
               callbacks[message['method']].each do |callback|
-                callback.call(message['params'])
+                Thread.new { callback.call(message['params']) }
               end
             end
           end

data/lib/selenium/webdriver/devtools/console_event.rb

@@ -0,0 +1,38 @@
+# 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 DevTools
+      class ConsoleEvent
+
+        attr_accessor :type, :timestamp, :args
+
+        def initialize(type:, timestamp:, args:)
+          @type = type.to_sym
+          @timestamp = Time.at(timestamp / 1000)
+          @args = args.map do |arg|
+            arg.key?('value') ? arg['value'] : arg
+          end
+        end
+
+      end # ConsoleEvent
+    end # DevTools
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/devtools/exception_event.rb

@@ -0,0 +1,36 @@
+# 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 DevTools
+      class ExceptionEvent
+
+        attr_accessor :description, :timestamp, :stacktrace
+
+        def initialize(description:, timestamp:, stacktrace:)
+          @description = description
+          @timestamp = Time.at(timestamp / 1000)
+          @stacktrace = stacktrace
+        end
+
+      end # ExceptionEvent
+    end # DevTools
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/devtools/mutation_event.rb

@@ -0,0 +1,37 @@
+# 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 DevTools
+      class MutationEvent
+
+        attr_accessor :element, :attribute_name, :current_value, :old_value
+
+        def initialize(element:, attribute_name:, current_value:, old_value:)
+          @element = element
+          @attribute_name = attribute_name
+          @current_value = current_value
+          @old_value = old_value
+        end
+
+      end # MutationEvent
+    end # DevTools
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/devtools/v84/accessibility.rb

@@ -0,0 +1,64 @@
+# 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.
+
+# This file is automatically generated. Any changes will be lost!
+module Selenium
+  module WebDriver
+    class DevTools
+      def accessibility
+        @accessibility ||= V84::Accessibility.new(self)
+      end
+
+      module V84
+        class Accessibility
+
+          def initialize(devtools)
+            @devtools = devtools
+          end
+
+          def on(event, &block)
+            event = EVENTS[event] if event.is_a?(Symbol)
+            @devtools.callbacks["Accessibility.#{event}"] << block
+          end
+
+          def disable
+            @devtools.send_cmd('Accessibility.disable')
+          end
+
+          def enable
+            @devtools.send_cmd('Accessibility.enable')
+          end
+
+          def get_partial_ax_tree(node_id: nil, backend_node_id: nil, object_id: nil, fetch_relatives: nil)
+            @devtools.send_cmd('Accessibility.getPartialAXTree',
+                               nodeId: node_id,
+                               backendNodeId: backend_node_id,
+                               objectId: object_id,
+                               fetchRelatives: fetch_relatives)
+          end
+
+          def get_full_ax_tree
+            @devtools.send_cmd('Accessibility.getFullAXTree')
+          end
+
+        end # V84
+      end # Accessibility
+    end # DevTools
+  end # WebDriver
+end # Selenium

data/lib/selenium/webdriver/devtools/v84/animation.rb

@@ -0,0 +1,100 @@
+# 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.
+
+# This file is automatically generated. Any changes will be lost!
+module Selenium
+  module WebDriver
+    class DevTools
+      def animation
+        @animation ||= V84::Animation.new(self)
+      end
+
+      module V84
+        class Animation
+          EVENTS = {
+            animation_canceled: 'animationCanceled',
+            animation_created: 'animationCreated',
+            animation_started: 'animationStarted',
+          }.freeze
+
+          def initialize(devtools)
+            @devtools = devtools
+          end
+
+          def on(event, &block)
+            event = EVENTS[event] if event.is_a?(Symbol)
+            @devtools.callbacks["Animation.#{event}"] << block
+          end
+
+          def disable
+            @devtools.send_cmd('Animation.disable')
+          end
+
+          def enable
+            @devtools.send_cmd('Animation.enable')
+          end
+
+          def get_current_time(id:)
+            @devtools.send_cmd('Animation.getCurrentTime',
+                               id: id)
+          end
+
+          def get_playback_rate
+            @devtools.send_cmd('Animation.getPlaybackRate')
+          end
+
+          def release_animations(animations:)
+            @devtools.send_cmd('Animation.releaseAnimations',
+                               animations: animations)
+          end
+
+          def resolve_animation(animation_id:)
+            @devtools.send_cmd('Animation.resolveAnimation',
+                               animationId: animation_id)
+          end
+
+          def seek_animations(animations:, current_time:)
+            @devtools.send_cmd('Animation.seekAnimations',
+                               animations: animations,
+                               currentTime: current_time)
+          end
+
+          def set_paused(animations:, paused:)
+            @devtools.send_cmd('Animation.setPaused',
+                               animations: animations,
+                               paused: paused)
+          end
+
+          def set_playback_rate(playback_rate:)
+            @devtools.send_cmd('Animation.setPlaybackRate',
+                               playbackRate: playback_rate)
+          end
+
+          def set_timing(animation_id:, duration:, delay:)
+            @devtools.send_cmd('Animation.setTiming',
+                               animationId: animation_id,
+                               duration: duration,
+                               delay: delay)
+          end
+
+        end # V84
+      end # Animation
+    end # DevTools
+  end # WebDriver
+end # Selenium