page-object 0.5.4 → 0.5.5

data/ChangeLog

@@ -1,3 +1,13 @@
+=== Version 0.5.5 / 2011-12-27
+* Enhancements
+  * Added ability to find Checkbox by :value
+  * Added ability to find HiddenField by :value
+  * Added ability to find a parent of an Element
+  * Added #fire_event method to Element
+  * Added #focus method to Element
+* Fixes
+  * Updated #populate_page_with to no longer attempt to set a value in a field that is disabled
+
 === Version 0.5.4 / 2011-12-18
 * Enhancements
   * Added deprecation warning to the method_missing method on Element.  This ability will be removed in 0.6

data/features/check_box.feature

@@ -23,6 +23,7 @@ Feature: Check Box
     | name      |
     | xpath     |
     | index     |
+    | value     |
 
   Scenario Outline: Locating check boxes using multiple parameters
     When I search for the check box by "<param1>" and "<param2>"

data/features/element.feature

@@ -253,3 +253,16 @@ Feature: Elements
     And I should know its' tag name is "h1"
     And I should know the attribute "readonly" is false
     And I should be able to click it
+
+  Scenario: Firing an event
+    When I set the focus to the test text_field using the onfocus event
+    Then I should see the onfocus text "changed by onfocus event"
+    
+  Scenario: Setting focus on an element
+    When I set the focus on the test text_field
+    Then I should see the onfocus text "changed by onfocus event"
+
+  Scenario: Finding a parent element
+    When I find the child link element
+    And ask for the parent element
+    Then I should have a div parent

data/features/hidden_field.feature

@@ -21,6 +21,7 @@ Feature: Hidden Fields
     | tag_name  |
     | index     |
     | text      |
+    | value     |
 
   Scenario Outline: Locating a hidden field using multiple parameters
     When I search for the hidden field by "<param1>" and "<param2>"

data/features/html/static_elements.html

@@ -87,6 +87,13 @@
     <h6 id="h6_id" class="h6_class" name="h6_name">h6's are cool</h6>
 
     <a href="success.html" target="_blank">New Window</a>
+    
+    <input type="text" id="onfocus_text_field" onfocus="document.getElementById('onfocus_test').innerHTML = 'changed by onfocus event'"/>
+    <div id="onfocus_test"></div>
+
+  <div id="parent_div">
+    <a href="success.html" id="child">Success</a>
+  </div>
   </body>
 </html>
 

data/features/nested_elements.feature

@@ -103,4 +103,4 @@ Feature: Nested Elements
   Scenario: Finding a paragraph within a div
     When I search for a paragraph located in a div
     Then I should see the nested paragraphs text should be "This is a paragraph."
-
+    

data/features/step_definitions/element_steps.rb

@@ -123,3 +123,27 @@ end
 Then /^it should know it is not enabled$/ do
   @element.should_not be_enabled
 end
+
+When /^I set the focus to the test text_field using the onfocus event$/ do
+  @page.text_field_element(:id => 'onfocus_text_field').fire_event('onfocus')
+end
+
+Then /^I should see the onfocus text "([^\"]*)"$/ do |text|
+  @page.div_element(:id => 'onfocus_test').text.should == text
+end
+
+When /^I set the focus on the test text_field$/ do
+  @page.text_field_element(:id => 'onfocus_text_field').focus
+end
+
+When /^I find the child link element$/ do
+  @element = @page.child_element
+end
+
+When /^ask for the parent element$/ do
+  @parent = @element.parent
+end
+
+Then /^I should have a div parent$/ do
+  @parent.should be_instance_of ::PageObject::Elements::Div
+end

data/features/support/env.rb

@@ -3,30 +3,5 @@ $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../', 'lib'))
 require 'rspec/expectations'
 require 'watir-webdriver'
 require 'selenium-webdriver'
-
 require 'page-object'
 
-
-
-Before do
-  @browser = PageObject::PersistantBrowser.get_browser
-end
-at_exit do
-  PageObject::PersistantBrowser.quit
-end
-
-module PageObject
-  module PersistantBrowser
-    @@browser = false
-    def self.get_browser 
-      if !@@browser 
-         @@browser =  Watir::Browser.new :firefox if ENV['DRIVER'] == 'WATIR' 
-         @@browser =  Selenium::WebDriver.for :firefox if ENV['DRIVER'] == 'SELENIUM'
-      end
-      @@browser
-    end
-    def self.quit
-      @@browser.quit
-    end
-  end  
-end

data/features/support/hooks.rb

@@ -0,0 +1,7 @@
+
+Before do
+  @browser = PageObject::PersistantBrowser.get_browser
+end
+at_exit do
+  PageObject::PersistantBrowser.quit
+end

data/features/support/page.rb

@@ -38,7 +38,7 @@ class Page
   hidden_field(:hidden_field_tag_name, :tag_name => "input[type='hidden']")
   hidden_field(:hidden_field_index, :index => 0)
   hidden_field(:hidden_field_text, :text => "")
-  hidden_field(:hidden_field_value, :value => "")
+  hidden_field(:hidden_field_value, :value => "12345")
   hidden_field(:hidden_field_class_index, :class => "hidden_field_class", :index => 0)
   hidden_field(:hidden_field_name_index, :name => "hidden_field_name", :index => 0)
 
@@ -67,6 +67,7 @@ class Page
   checkbox(:cb_class, :class => 'cb_class')
   checkbox(:cb_index, :index => 0)
   checkbox(:cb_xpath, :xpath => "//input[@type='checkbox']")
+  checkbox(:cb_value, :value => '1')
   checkbox(:cb_class_index, :class => "cb_class", :index => 0)
   checkbox(:cb_name_index, :name => "cb_name", :index => 0)
 
@@ -254,5 +255,6 @@ class Page
   file_field(:file_field_xpath, :xpath => "//input[@type='file']")
   
   link(:open_window, :text => 'New Window')
+  link(:child, :id => 'child')
 end
 

data/features/support/persistent_browser.rb

@@ -0,0 +1,16 @@
+
+module PageObject
+  module PersistantBrowser
+    @@browser = false
+    def self.get_browser
+      if !@@browser
+         @@browser =  Watir::Browser.new :firefox if ENV['DRIVER'] == 'WATIR'
+         @@browser =  Selenium::WebDriver.for :firefox if ENV['DRIVER'] == 'SELENIUM'
+      end
+      @@browser
+    end
+    def self.quit
+      @@browser.quit
+    end
+  end
+end

data/lib/page-object/accessors.rb

@@ -102,6 +102,7 @@ module PageObject
     #   * :name => Watir and Selenium
     #   * :tag_name => Watir and Selenium
     #   * :text => Watir and Selenium
+    #   * :value => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
@@ -242,6 +243,7 @@ module PageObject
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
+    #   * :value => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #

data/lib/page-object/elements.rb

@@ -1,3 +1,31 @@
+module PageObject
+  module Elements
+    class << self
+
+      #
+      # method to return the collection of tag_name to class mappings
+      #
+      def tag_to_class
+        @tag_to_class ||= {}
+      end
+
+      def type_to_class
+        @type_to_class ||= {}
+      end
+
+      #
+      # method to return the element for a tag_name
+      #
+      def element_class_for(tag_name, type=nil)
+        return type_to_class[type] if type
+        tag_to_class[tag_name.to_sym] || ::PageObject::Elements::Element
+      end
+      
+    end
+  end
+end
+
+
 require 'page-object/elements/element'
 require 'page-object/elements/link'
 require 'page-object/elements/text_field'
@@ -21,3 +49,4 @@ require 'page-object/elements/option'
 require 'page-object/elements/heading'
 require 'page-object/elements/paragraph'
 require 'page-object/elements/file_field'
+

data/lib/page-object/elements/button.rb

@@ -26,5 +26,10 @@ module PageObject
         end
       end
     end
+
+    ::PageObject::Elements.type_to_class[:submit] = ::PageObject::Elements::Button
+    ::PageObject::Elements.type_to_class[:image] = ::PageObject::Elements::Button
+    ::PageObject::Elements.type_to_class[:button] = ::PageObject::Elements::Button
+    ::PageObject::Elements.type_to_class[:reset] = ::PageObject::Elements::Button
   end
 end

data/lib/page-object/elements/check_box.rb

@@ -9,6 +9,14 @@ module PageObject
       end
 
       protected
+
+      def self.watir_finders
+        super + [:value]
+      end
+
+      def self.selenium_finders
+        super + [:value]
+      end
       
       def include_platform_for platform
         super
@@ -23,5 +31,8 @@ module PageObject
         end
       end
     end
+
+    ::PageObject::Elements.type_to_class[:checkbox] = ::PageObject::Elements::CheckBox
+    
   end
 end

data/lib/page-object/elements/div.rb

@@ -13,5 +13,7 @@ module PageObject
       end
       
     end
+
+    ::PageObject::Elements.tag_to_class[:div] = ::PageObject::Elements::Div
   end
-end
+end

data/lib/page-object/elements/element.rb

@@ -1,3 +1,4 @@
+require 'page-object/nested_elements'
 
 module PageObject
   module Elements
@@ -8,7 +9,7 @@ module PageObject
     # @see PageObject::Platforms::SeleniumWebDriver::Element for the Selenium version of all common methods
     #
     class Element
-      include Object::PageObject::NestedElements
+      include ::PageObject::NestedElements
       
       attr_reader :element
 

data/lib/page-object/elements/file_field.rb

@@ -31,5 +31,8 @@ module PageObject
         end
       end
     end
+
+    ::PageObject::Elements.type_to_class[:file] = ::PageObject::Elements::FileField
+    
   end
 end

data/lib/page-object/elements/form.rb

@@ -30,5 +30,7 @@ module PageObject
         end
       end
     end
+
+    ::PageObject::Elements.tag_to_class[:form] = ::PageObject::Elements::Form
   end
 end

data/lib/page-object/elements/heading.rb

@@ -3,5 +3,13 @@ module PageObject
     class Heading < Element
 
     end
+
+    ::PageObject::Elements.tag_to_class[:h1] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h2] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h3] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h4] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h5] = ::PageObject::Elements::Heading
+    ::PageObject::Elements.tag_to_class[:h6] = ::PageObject::Elements::Heading
+    
   end
-end
+end

data/lib/page-object/elements/hidden_field.rb

@@ -9,7 +9,7 @@ module PageObject
       protected
 
       def self.watir_finders
-        super + [:tag_name, :text]
+        super + [:tag_name, :text, :value]
       end
 
       def self.watir_mapping
@@ -17,12 +17,14 @@ module PageObject
       end
 
       def self.selenium_finders
-        super + [:css]
+        super + [:css, :value]
       end
 
       def self.selenium_mapping
         super.merge({:tag_name => :css})
       end
     end
+
+    ::PageObject::Elements.type_to_class[:hidden] = ::PageObject::Elements::HiddenField
   end
-end
+end

data/lib/page-object/elements/image.rb

@@ -28,7 +28,9 @@ module PageObject
           raise ArgumentError, "expect platform to be :watir_webdriver or :selenium_webdriver"
         end
       end
-
     end
+
+    ::PageObject::Elements.tag_to_class[:img] = ::PageObject::Elements::Image
+    
   end
 end

data/lib/page-object/elements/link.rb

@@ -34,5 +34,8 @@ module PageObject
         end
       end
     end
+    
+    ::PageObject::Elements.tag_to_class[:a] = ::PageObject::Elements::Link
+
   end
 end

data/lib/page-object/elements/list_item.rb

@@ -3,5 +3,8 @@ module PageObject
     class ListItem < Element
 
     end
+
+    ::PageObject::Elements.tag_to_class[:li] = ::PageObject::Elements::ListItem
+    
   end
-end
+end

data/lib/page-object/elements/option.rb

@@ -3,5 +3,8 @@ module PageObject
     class Option < Element
 
     end
+
+    ::PageObject::Elements.tag_to_class[:option] = ::PageObject::Elements::Option
+    
   end
 end

data/lib/page-object/elements/ordered_list.rb

@@ -44,5 +44,7 @@ module PageObject
       end
 
     end
+
+    ::PageObject::Elements.tag_to_class[:ol] = ::PageObject::Elements::OrderedList
   end
 end

data/lib/page-object/elements/paragraph.rb

@@ -3,5 +3,7 @@ module PageObject
     class Paragraph < Element
 
     end
+
+    ::PageObject::Elements.tag_to_class[:p] = ::PageObject::Elements::Paragraph
   end
-end
+end

data/lib/page-object/elements/radio_button.rb

@@ -31,5 +31,7 @@ module PageObject
         end
       end
     end
+
+    ::PageObject::Elements.type_to_class[:radio] = ::PageObject::Elements::RadioButton
   end
 end

data/lib/page-object/elements/select_list.rb

@@ -32,5 +32,7 @@ module PageObject
       end
 
     end
+
+    ::PageObject::Elements.tag_to_class[:select] = ::PageObject::Elements::SelectList
   end
 end