rainux-selenium-webdriver 0.0.17

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

@@ -0,0 +1,24 @@
+module Selenium
+  module WebDriver
+    module DriverExtensions
+      module TakesScreenshot
+
+        def save_screenshot(png_path)
+          File.open(png_path, 'w') { |f| f << screenshot_as(:png) }
+        end
+
+        def screenshot_as(format)
+          case format
+          when :base64
+            bridge.getScreenshotAsBase64
+          when :png
+            bridge.getScreenshotAsBase64.unpack("m")[0]
+          else
+            raise Error::UnsupportedOperationError, "unsupported format: #{format.inspect}"
+          end
+        end
+
+      end # TakesScreenshot
+    end # DriverExtensions
+  end # WebDriver
+end # Selenium

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

@@ -0,0 +1,262 @@
+module Selenium
+  module WebDriver
+    class Element
+      include Find
+
+      attr_reader :bridge
+
+      #
+      # Creates a new Element
+      #
+      # @api private
+      #
+
+      def initialize(bridge, id)
+        @bridge, @id = bridge, id
+      end
+
+      def inspect
+        '#<%s:0x%x id=%s tag_name=%s>' % [self.class, hash*2, @id.inspect, tag_name.inspect]
+      end
+
+      #
+      # Click the element
+      #
+
+      def click
+        bridge.clickElement @id
+      end
+
+      #
+      # Get the tag name of this element
+      #
+      # @return [String]
+      #
+
+      def tag_name
+        bridge.getElementTagName @id
+      end
+
+      #
+      # Get the value of this element
+      #
+      # @return [String]
+      #
+
+      def value
+        bridge.getElementValue @id
+      end
+
+      #
+      # Get the value of the given attribute
+      #
+      # @param [String]
+      #   attribute name
+      # @return [String,nil]
+      #   attribute value
+      #
+
+      def attribute(name)
+        bridge.getElementAttribute @id, name
+      end
+
+      #
+      # Get the text content of this element
+      #
+      # @return [String]
+      #
+
+      def text
+        bridge.getElementText @id
+      end
+
+      #
+      # Send keystrokes to this element
+      #
+      # @param [String, Symbol, Array]
+      #
+      # Examples:
+      #
+      #     element.send_keys "foo"                     #=> value: 'foo'
+      #     element.send_keys "tet", :arrow_left, "s"   #=> value: 'test'
+      #     element.send_keys [:control, 'a'], :space   #=> value: ' '
+      #
+      # @see Keys::KEYS
+      #
+
+      def send_keys(*args)
+        args.each do |arg|
+          case arg
+          when Symbol
+            arg = Keys[arg]
+          when Array
+            arg = arg.map { |e| e.kind_of?(Symbol) ? Keys[e] : e }.join
+            arg << Keys[:null]
+          end
+
+          bridge.sendKeysToElement(@id, arg.to_s)
+        end
+      end
+      alias_method :send_key, :send_keys
+
+      #
+      # Clear this element
+      #
+
+      def clear
+        bridge.clearElement @id
+      end
+
+      #
+      # Is the element enabled?
+      #
+      # @return [Boolean]
+      #
+
+      def enabled?
+        bridge.isElementEnabled @id
+      end
+
+      #
+      # Is the element selected?
+      #
+      # @return [Boolean]
+      #
+
+      def selected?
+        bridge.isElementSelected @id
+      end
+
+      #
+      # Is the element displayed?
+      #
+      # @return [Boolean]
+      #
+
+      def displayed?
+        bridge.isElementDisplayed @id
+      end
+
+      #
+      # Select this element
+      #
+
+      def select
+        bridge.setElementSelected @id
+      end
+
+      #
+      # Submit this element
+      #
+
+      def submit
+        bridge.submitElement @id
+      end
+
+      #
+      # Toggle this element
+      #
+
+      def toggle
+        bridge.toggleElement @id
+      end
+
+      #
+      # Get the value of the given CSS property
+      #
+
+      def style(prop)
+        bridge.getElementValueOfCssProperty @id, prop
+      end
+
+      #
+      # Hover over this element. Not applicable to all browsers.
+      #
+
+      def hover
+        bridge.hoverOverElement @id
+      end
+
+      #
+      # Get the location of this element.
+      #
+      # @return [WebDriver::Point]
+      #
+
+      def location
+        bridge.getElementLocation @id
+      end
+
+      #
+      # Get the size of this element
+      #
+      # @return [WebDriver::Dimension]
+      #
+
+      def size
+        bridge.getElementSize @id
+      end
+
+      #
+      # Drag and drop this element
+      #
+      # @param [Integer] right_by
+      #   number of pixels to drag right
+      # @param [Integer] down_by
+      #   number of pixels to drag down
+      #
+
+      def drag_and_drop_by(right_by, down_by)
+        bridge.dragElement @id, right_by, down_by
+      end
+
+      #
+      # Drag and drop this element on the given element
+      #
+      # @param [WebDriver::Element] other
+      #
+
+      def drag_and_drop_on(other)
+        current_location = location()
+        destination      = other.location
+
+        right = destination.x - current_location.x
+        down  = destination.y - current_location.y
+
+        drag_and_drop_by right, down
+      end
+
+      #-------------------------------- sugar  --------------------------------
+
+      #
+      #   element.first(:id, 'foo')
+      #
+
+      alias_method :first, :find_element
+
+      #
+      #   element.all(:class, 'bar')
+      #
+
+      alias_method :all, :find_elements
+
+      #
+      #   element['class'] or element[:class] #=> "someclass"
+      #
+      alias_method :[], :attribute
+
+      #
+      # for Find and execute_script
+      #
+      # @api private
+      #
+
+      def ref
+        @id
+      end
+
+
+
+    end # Element
+  end # WebDriver
+end # Selenium

data/common/src/rb/lib/selenium/webdriver/error.rb

@@ -0,0 +1,67 @@
+module Selenium
+  module WebDriver
+    module Error
+
+      class WebDriverError < StandardError; end
+      class IndexOutOfBoundsError < WebDriverError; end        # 1
+      class NoCollectionError < WebDriverError; end            # 2
+      class NoStringError < WebDriverError; end                # 3
+      class NoStringLengthError < WebDriverError; end          # 4
+      class NoStringWrapperError < WebDriverError; end         # 5
+      class NoSuchDriverError < WebDriverError; end            # 6
+      class NoSuchElementError < WebDriverError; end           # 7
+      class NoSuchFrameError < WebDriverError; end             # 8
+      # NotImplementedError                                    # 9 - just use Ruby's
+      class ObsoleteElementError < WebDriverError; end         # 10
+      class ElementNotDisplayedError < WebDriverError; end     # 11
+      class ElementNotEnabledError < WebDriverError; end       # 12
+      class UnhandledError < WebDriverError; end               # 13
+      class ExpectedError < WebDriverError; end                # 14
+      class ElementNotSelectedError < WebDriverError; end      # 15
+      class NoSuchDocumentError < WebDriverError; end          # 16
+      class UnexpectedJavascriptError < WebDriverError; end    # 17
+      class NoScriptResultError < WebDriverError; end          # 18
+      class UnknownScriptResultError < WebDriverError; end     # 19
+      class NoSuchCollectionError < WebDriverError; end        # 20
+      class TimeOutError < WebDriverError; end                 # 21
+      class NullPointerError < WebDriverError; end             # 22
+      class NoSuchWindowError < WebDriverError; end            # 23
+      class UnsupportedOperationError < WebDriverError; end
+
+      Errors = [
+        IndexOutOfBoundsError,
+        NoCollectionError,
+        NoStringError,
+        NoStringLengthError,
+        NoStringWrapperError,
+        NoSuchDriverError,
+        NoSuchElementError,
+        NoSuchFrameError,
+        NotImplementedError,
+        ObsoleteElementError,
+        ElementNotDisplayedError,
+        ElementNotEnabledError,
+        UnhandledError,
+        ExpectedError,
+        ElementNotSelectedError,
+        NoSuchDocumentError,
+        UnexpectedJavascriptError,
+        NoScriptResultError,
+        UnknownScriptResultError,
+        NoSuchCollectionError,
+        TimeOutError,
+        NullPointerError,
+        NoSuchWindowError
+      ]
+
+      class << self
+        def for_code(code)
+          return if code == 0
+
+          Errors[code - 1] || WebDriverError
+        end
+      end
+
+    end # Error
+  end # WebDriver
+end # Selenium

data/common/src/rb/lib/selenium/webdriver/find.rb

@@ -0,0 +1,89 @@
+module Selenium
+  module WebDriver
+    module Find
+
+      FINDERS = {
+        :class             => 'ClassName',
+        :class_name        => 'ClassName',
+        :css               => 'CssSelector',
+        :id                => 'Id',
+        :link              => 'LinkText',
+        :link_text         => 'LinkText',
+        :name              => 'Name',
+        :partial_link_text => 'PartialLinkText',
+        :tag_name          => 'TagName',
+        :xpath             => 'Xpath',
+        :js_expr           => 'JsExpr',
+        :javascript        => 'Javascript',
+      }
+
+      #
+      # Find the first element matching the given arguments.
+      #
+      # @param [:class, :class_name, :id, :link_text, :link, :partial_link_text, :name, :tag_name, :xpath] how
+      # @param [String] what
+      # @return [WebDriver::Element]
+      #
+      # @raise [NoSuchElementError] if the element doesn't exist
+      #
+
+      def find_element(*args)
+        how, what = extract_args(args)
+
+        unless by = FINDERS[how.to_sym]
+          raise ArgumentError, "cannot find element by #{how.inspect}"
+        end
+
+        meth = "findElementBy#{by}"
+        what = what.to_s
+
+        bridge.send meth, ref, what
+      end
+
+      #
+      # Find all elements matching the given arguments
+      #
+      # @param [:class, :class_name, :id, :link_text, :link, :partial_link_text, :name, :tag_name, :xpath] how
+      # @param [String] what
+      # @return [Array<WebDriver::Element>]
+      #
+
+      def find_elements(*args)
+        how, what = extract_args(args)
+
+        unless by = FINDERS[how.to_sym]
+          raise ArgumentError, "cannot find elements by #{how.inspect}"
+        end
+
+        meth = "findElementsBy#{by}"
+        what = what.to_s
+
+        bridge.send meth, ref, what
+      end
+
+      private
+
+      def extract_args(args)
+        case args.size
+        when 2
+          args
+        when 1
+          arg = args.first
+          unless arg.respond_to?(:shift)
+            raise ArgumentError, "expected #{arg.inspect}:#{arg.class} to respond to #shift"
+          end
+
+          arr = arg.shift
+          unless arr.size == 2
+            raise ArgumentError, "expected #{arr.inspect} to have 2 elements"
+          end
+
+          arr
+        else
+          raise ArgumentError, "wrong number of arguments (#{args.size} for 2)"
+        end
+      end
+
+    end # Find
+  end # WebDriver
+end # Selenium

data/common/src/rb/lib/selenium/webdriver/keys.rb

@@ -0,0 +1,84 @@
+# encoding: utf-8
+
+module Selenium
+  module WebDriver
+    module Keys
+
+      #
+      # @see Element#send_keys
+      #
+      # http://www.google.com.au/search?&q=unicode+pua&btnG=Search
+      #
+
+      KEYS = {
+      # \x works on both 1.8.6/1.9
+        :null         => "\xEE\x80\x80",
+        :cancel       => "\xEE\x80\x81",
+        :help         => "\xEE\x80\x82",
+        :backspace    => "\xEE\x80\x83",
+        :tab          => "\xEE\x80\x84",
+        :clear        => "\xEE\x80\x85",
+        :return       => "\xEE\x80\x86",
+        :enter        => "\xEE\x80\x87",
+        :shift        => "\xEE\x80\x88",
+        :left_shift   => "\xEE\x80\x88",
+        :control      => "\xEE\x80\x89",
+        :left_control => "\xEE\x80\x89",
+        :alt          => "\xEE\x80\x8A",
+        :left_alt     => "\xEE\x80\x8A",
+        :pause        => "\xEE\x80\x8B",
+        :escape       => "\xEE\x80\x8C",
+        :space        => "\xEE\x80\x8D",
+        :page_up      => "\xEE\x80\x8E",
+        :page_down    => "\xEE\x80\x8F",
+        :end          => "\xEE\x80\x90",
+        :home         => "\xEE\x80\x91",
+        :left         => "\xEE\x80\x92",
+        :arrow_left   => "\xEE\x80\x92",
+        :up           => "\xEE\x80\x93",
+        :arrow_up     => "\xEE\x80\x93",
+        :right        => "\xEE\x80\x94",
+        :arrow_right  => "\xEE\x80\x94",
+        :down         => "\xEE\x80\x95",
+        :arrow_down   => "\xEE\x80\x95",
+        :insert       => "\xEE\x80\x96",
+        :delete       => "\xEE\x80\x97",
+        :semicolon    => "\xEE\x80\x98",
+        :equals       => "\xEE\x80\x99",
+        :numpad0      => "\xEE\x80\x9A",
+        :numpad1      => "\xEE\x80\x9B",
+        :numpad2      => "\xEE\x80\x9C",
+        :numpad3      => "\xEE\x80\x9D",
+        :numpad4      => "\xEE\x80\x9E",
+        :numpad5      => "\xEE\x80\x9F",
+        :numpad6      => "\xEE\x80\xA0",
+        :numpad7      => "\xEE\x80\xA1",
+        :numpad8      => "\xEE\x80\xA2",
+        :numpad9      => "\xEE\x80\xA3",
+        :multiply     => "\xEE\x80\xA4",
+        :add          => "\xEE\x80\xA5",
+        :separator    => "\xEE\x80\xA6",
+        :subtract     => "\xEE\x80\xA7",
+        :decimal      => "\xEE\x80\xA8",
+        :divide       => "\xEE\x80\xA9",
+        :f1           => "\xEE\x80\xB1",
+        :f2           => "\xEE\x80\xB2",
+        :f3           => "\xEE\x80\xB3",
+        :f4           => "\xEE\x80\xB4",
+        :f5           => "\xEE\x80\xB5",
+        :f6           => "\xEE\x80\xB6",
+        :f7           => "\xEE\x80\xB7",
+        :f8           => "\xEE\x80\xB8",
+        :f9           => "\xEE\x80\xB9",
+        :f10          => "\xEE\x80\xBA",
+        :f11          => "\xEE\x80\xBB",
+        :f12          => "\xEE\x80\xBC"
+      }
+
+      def self.[](key)
+        KEYS[key] || raise(Error::UnsupportedOperationError, "no such key #{key.inspect}")
+      end
+
+    end # Keys
+  end # WebDriver
+end # Selenium