ayanko-watir-webdriver 0.1.1.1

data/lib/watir-webdriver/elements/hidden.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+module Watir
+  class Hidden < Input
+    def visible?
+      false
+    end
+  end
+
+  module Container
+    def hidden(*args)
+      Hidden.new(self, extract_selector(args).merge(:tag_name => "input", :type => "hidden"))
+    end
+
+    def hiddens(*args)
+      HiddenCollection.new(self, extract_selector(args).merge(:tag_name => "input", :type => "hidden"))
+    end
+  end # Container
+
+  class HiddenCollection < InputCollection
+    def element_class
+      Hidden
+    end
+  end # HiddenCollection
+end

data/lib/watir-webdriver/elements/image.rb

@@ -0,0 +1,51 @@
+# encoding: utf-8
+module Watir
+  class Image < HTMLElement
+
+    alias_method :loaded?, :complete?
+
+    #
+    # returns the image's width in pixels
+    #
+    # @return [Integer] width
+    #
+
+    def width
+      assert_exists
+      driver.execute_script "return arguments[0].width", @element
+    end
+
+    #
+    # returns the image's height in pixels
+    #
+    # @return [Integer] height
+    #
+
+    def height
+      assert_exists
+      driver.execute_script "return arguments[0].height", @element
+    end
+
+    def file_created_date
+      assert_exists
+      raise NotImplementedError
+    end
+
+    def file_size
+      assert_exists
+      raise NotImplementedError
+    end
+
+    def save(path)
+      assert_exists
+      raise NotImplementedError
+    end
+
+  end # Image
+
+  module Container
+     alias_method :image, :img
+     alias_method :images, :imgs
+  end # Container
+
+end # Watir

data/lib/watir-webdriver/elements/input.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+module Watir
+  class Input < HTMLElement
+
+    alias_method :readonly?, :read_only?
+
+    #
+    # @private
+    #
+    # subclasses can use this to validate the incoming element
+    #
+
+    def self.from(parent, element)
+      unless element.tag_name == "input"
+        raise TypeError, "can't create #{self} from #{element.inspect}"
+      end
+
+      new(parent, :element => element)
+    end
+
+    def enabled?
+      !disabled?
+    end
+
+    #
+    # Return the type attribute of the element, or 'text' if the attribute is invalid.
+    # TODO: discuss.
+    #
+    # @return [String]
+    #
+
+    def type
+      assert_exists
+      value = @element.attribute("type").to_s
+
+      # we return 'text' if the type is invalid
+      # not sure if we really should do this
+      TextFieldLocator::NON_TEXT_TYPES.include?(value) ? value : 'text'
+    end
+
+  end # Input
+end # Watir

data/lib/watir-webdriver/elements/link.rb

@@ -0,0 +1,7 @@
+# encoding: utf-8
+module Watir
+  module Container
+    alias_method :link,  :a
+    alias_method :links, :as
+  end
+end # Watir

data/lib/watir-webdriver/elements/option.rb

@@ -0,0 +1,55 @@
+# encoding: utf-8
+module Watir
+
+  #
+  # Represents an option in a select list.
+  #
+
+  class Option < HTMLElement
+
+    #
+    # Select this option
+    #
+
+    def select
+      assert_exists
+
+      @element.select
+      fire_event("onclick") rescue nil
+    end
+
+    #
+    # Toggle the selected state of this option
+    #
+
+    def toggle
+      assert_exists
+      @element.toggle
+    end
+
+    #
+    # Is this option selected?
+    #
+
+    def selected?
+      assert_exists
+      @element.selected?
+    end
+
+    def text
+      assert_exists
+
+      # A little unintuitive - we'll return the 'label' or 'text' attribute if
+      # they exist, otherwise the inner text of the element
+
+      attribute = [:label, :text].find { |a| attribute? a }
+
+      if attribute
+        @element.attribute(attribute)
+      else
+        @element.text
+      end
+    end
+
+  end # Option
+end # Watir

data/lib/watir-webdriver/elements/radio.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+module Watir
+  class Radio < Input
+    def self.from(parent, element)
+      if element.attribute(:type) != "radio"
+        raise TypeError, "expected type=radio for #{element.inspect}"
+      end
+
+      super
+    end
+    #
+    # Select this radio button.
+    #
+
+    def set
+      assert_exists
+      assert_enabled
+
+      @element.click unless set?
+    end
+
+    #
+    # Is this radio set?
+    #
+
+    def set?
+      assert_exists
+      @element.selected?
+    end
+  end # Radio
+
+  module Container
+    def radio(*args)
+      Radio.new(self, extract_selector(args).merge(:tag_name => "input", :type => "radio"))
+    end
+
+    def radios(*args)
+      RadioCollection.new(self, extract_selector(args).merge(:tag_name => "input", :type => "radio" ))
+    end
+  end # Container
+
+  class RadioCollection < InputCollection
+    private
+
+    def element_class
+      Radio
+    end
+  end # RadioCollection
+end # Watir

data/lib/watir-webdriver/elements/select.rb

@@ -0,0 +1,216 @@
+# encoding: utf-8
+module Watir
+  class Select < HTMLElement
+    include Watir::Exception
+
+    #
+    # Returns true if this element is enabled
+    #
+    # @return [Boolean]
+    #
+
+    def enabled?
+      !disabled?
+    end
+
+    #
+    # Clear all selected options
+    #
+
+    def clear
+      assert_exists
+
+      raise Error, "you can only clear multi-selects" unless multiple?
+
+      options.each do |o|
+        o.toggle if o.selected?
+      end
+    end
+
+    def options
+      assert_exists
+      super
+    end
+
+    #
+    # Returns true if the select list has one or more options where text or label matches the given value.
+    #
+    # @param [String, Regexp] value A value.
+    # @return [Boolean]
+    #
+
+    def include?(str_or_rx)
+      assert_exists
+      # TODO: optimize similar to selected?
+      options.any? { |e| str_or_rx === e.text }
+    end
+
+    #
+    # Select the option(s) whose text or label matches the given string.
+    # If this is a multi-select and several options match the value given, all will be selected.
+    #
+    # @param [String, Regexp] value A value.
+    # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
+    # @return [String] The text of the option selected. If multiple options match, returns the first match.
+    #
+
+    def select(str_or_rx)
+      select_by :text, str_or_rx
+    end
+
+    #
+    # Selects the option(s) whose value attribute matches the given string.
+    #
+    # @see +select+
+    #
+    # @param [String, Regexp] value A value.
+    # @raise [Watir::Exception::NoValueFoundException] if the value does not exist.
+    # @return [String] The option selected. If multiple options match, returns the first match
+    #
+
+    def select_value(str_or_rx)
+      select_by :value, str_or_rx
+    end
+
+    #
+    # Returns true if any of the selected options' text or label match the given value.
+    #
+    # @param [String, Regexp] value A value.
+    # @raise [Watir::Exception::UnknownObjectException] if the value does not exist.
+    # @return [Boolean]
+    #
+
+    def selected?(str_or_rx)
+      assert_exists
+      matches = @element.find_elements(:tag_name, 'option').select { |e| str_or_rx === e.text || str_or_rx === e.attribute(:label) }
+
+      if matches.empty?
+        raise UnknownObjectException, "Unable to locate option matching #{str_or_rx.inspect}"
+      end
+
+      matches.any? { |e| e.selected? }
+    end
+
+    #
+    # Returns the value of the first selected option in the select list.
+    # Returns nil if no option is selected.
+    #
+    # @return [String, nil]
+    #
+
+    def value
+      o = options.find { |e| e.selected? } || return
+      o.value
+    end
+
+
+    #
+    # @return [Array<String>] An array of strings representing the text value of the currently selected options.
+    #
+
+    def selected_options
+      assert_exists
+      options.map { |e| e.text if e.selected? }.compact
+    end
+
+    private
+
+    def select_by(how, str_or_rx)
+      assert_exists
+
+      case str_or_rx
+      when String, Numeric
+        select_by_string(how, str_or_rx.to_s)
+      when Regexp
+        select_by_regexp(how, str_or_rx)
+      else
+        raise TypeError, "expected String or Regexp, got #{str_or_rx.inspect}:#{str_or_rx.class}"
+      end
+    end
+
+    def select_by_string(how, string)
+      xpath = option_xpath_for(how, string)
+
+      if multiple?
+        elements = @element.find_elements(:xpath, xpath)
+        no_value_found(string) if elements.empty?
+
+        elements.each { |e| e.select unless e.selected? }
+        elements.first.text
+      else
+        begin
+          e = @element.find_element(:xpath, xpath)
+        rescue WebDriver::Error::NoSuchElementError
+          no_value_found(string)
+        end
+
+        e.select unless e.selected?
+
+        safe_text(e)
+      end
+    end
+
+    def select_by_regexp(how, exp)
+      elements = @element.find_elements(:tag_name, 'option')
+      no_value_found(nil, "no options in select list") if elements.empty?
+
+      if multiple?
+        found = elements.select do |e|
+          next unless matches_regexp?(how, e, exp)
+          e.select unless e.selected?
+          true
+        end
+
+        no_value_found(exp) if found.empty?
+
+        found.first.text
+      else
+        element = elements.find { |e| matches_regexp?(how, e, exp) }
+        no_value_found(exp) unless element
+
+        element.select unless element.selected?
+
+        safe_text(element)
+      end
+    end
+
+    def option_xpath_for(how, string)
+      case how
+      when :text
+        ".//option[normalize-space()='#{string}' or @label='#{string}']"
+      when :value
+        ".//option[@value='#{string}']"
+      else
+        raise Error, "unknown how: #{how.inspect}"
+      end
+    end
+
+    def matches_regexp?(how, element, exp)
+      case how
+      when :text
+        element.text =~ exp || element.attribute(:label) =~ exp
+      when :value
+        element.attribute(:value) =~ exp
+      else
+        raise Error, "unknown how: #{how.inspect}"
+      end
+    end
+
+    def safe_text(element)
+      element.text
+    rescue Selenium::WebDriver::Error::ObsoleteElementError
+      # guard for scenario where selecting the element changes the page, making our element obsolete
+
+      ''
+    end
+
+    def no_value_found(arg, msg = nil)
+      raise NoValueFoundException, msg || "#{arg.inspect} not found in select list"
+    end
+  end # Select
+
+  module Container
+    alias_method :select_list,  :select
+    alias_method :select_lists, :selects
+  end # Container
+end # Watir