RubyGems - page-object - Versions diffs - 0.3.1 → 0.3.2 - Mend

page-object 0.3.1 → 0.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (32) hide show

data/ChangeLog +13 -1
data/features/element.feature +10 -0
data/features/headings.feature +54 -0
data/features/html/nested_elements.html +6 -2
data/features/html/static_elements.html +11 -26
data/features/nested_elements.feature +14 -1
data/features/step_definitions/element_steps.rb +4 -0
data/features/step_definitions/headings_steps.rb +12 -0
data/features/step_definitions/nested_elements_steps.rb +27 -0
data/features/step_definitions/text_area_steps.rb +4 -0
data/features/support/page.rb +24 -0
data/features/text_area.feature +6 -0
data/lib/page-object/accessors.rb +87 -0
data/lib/page-object/element_locators.rb +45 -0
data/lib/page-object/elements.rb +1 -0
data/lib/page-object/elements/element.rb +1 -1
data/lib/page-object/elements/heading.rb +7 -0
data/lib/page-object/nested_elements.rb +12 -0
data/lib/page-object/platforms/selenium_webdriver/element.rb +3 -12
data/lib/page-object/platforms/selenium_webdriver/page_object.rb +72 -0
data/lib/page-object/platforms/watir_webdriver/element.rb +3 -0
data/lib/page-object/platforms/watir_webdriver/page_object.rb +57 -0
data/lib/page-object/platforms/watir_webdriver/text_area.rb +7 -0
data/lib/page-object/version.rb +1 -1
data/page-object.gemspec +1 -1
data/spec/page-object/accessors_spec.rb +135 -0
data/spec/page-object/element_locators_spec.rb +18 -0
data/spec/page-object/elements/element_spec.rb +42 -0
data/spec/page-object/elements/heading_spec.rb +22 -0
data/spec/page-object/elements/nested_element_spec.rb +33 -3
metadata +11 -6
data/features/element_attributes.feature +0 -233

data/ChangeLog CHANGED Viewed

@@ -1,4 +1,16 @@
-=== Version -0.3.1 / 2011-09-08
+=== Version 0.3.2 / 2011-09-22
+* Enhancements
+  * Element#when_present now returns the element object
+  * Element#when_visible now returns the element object
+  * Element#when_not_visible now returns the element object
+  * Added #clear method for TextArea
+  * Added support for Heading element
+  * Added all of the h1 locators
+  * Added all of the h2 locators
+  * Added all of the h3 locators
+  * Updated to use selenium-webdriver 2.6.0
+=== Version 0.3.1 / 2011-09-08
 * Enhancements
   * Updated to use watir-webdriver 0.3.3

data/features/element.feature CHANGED Viewed

@@ -237,3 +237,13 @@ Feature: Elements
     And I should know its' tag name is "ol"
     And I should know the attribute "readonly" is false
     And I should be able to click it
+  Scenario: Heading element methods
+    When I retrieve a heading element
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text is "h1's are cool"
+    And I should know it is equal to itself
+    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

data/features/headings.feature ADDED Viewed

@@ -0,0 +1,54 @@
+Feature: Headings
+  Background:
+    Given I am on the static elements page
+  Scenario: Getting the text of headings
+    When I get the text for the "h1" element
+    Then I should see "h1's are cool"
+    When I get the text for the "h2" element
+    Then I should see "h2's are cool"
+    When I get the text for the "h3" element
+    Then I should see "h3's are cool"
+#    When I get the text for the "h4" element
+#    Then I should see "h4's are cool"
+#    When I get the text for the "h5" element
+#    Then I should see "h5's are cool"
+#    When I get the text for the "h6" element
+#    Then I should see "h6's are cool"
+  Scenario Outline: Locating h1s on the Page
+    When I search for the heading1 by "<search_by>"
+    Then I should see "h1's are cool"
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | name      |
+    | xpath     |
+    | index     |
+  Scenario Outline: Locating h2s on the Page
+    When I search for the heading2 by "<search_by>"
+    Then I should see "h2's are cool"
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | name      |
+    | xpath     |
+    | index     |
+  Scenario Outline: Locating h3s on the Page
+    When I search for the heading3 by "<search_by>"
+    Then I should see "h3's are cool"
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | name      |
+    | xpath     |
+    | index     |

data/features/html/nested_elements.html CHANGED Viewed

@@ -3,7 +3,6 @@
     <title>Nested Elements</title>
 </head>
 <body>
-  <h1>Nested Elements</h1>
   <div id="div_id">
     <a href="success.html">Success</a>
@@ -36,7 +35,12 @@
     <ul>
         <li>Item One</li>
         <li>Item Two</li>
-    </ul>
+    </ul
   </div>
+  <h1>h1's are cool</h1>
+  <h2>h2's are cool</h2>
+  <h3>h3's are cool</h3>
 </body>
 </html>

data/features/html/static_elements.html CHANGED Viewed

@@ -3,49 +3,37 @@
     <title>Static Elements Page</title>
 </head>
   <body>
-    <h2>Static Elements Page</h2>
+    <p>Static Elements Page</p>
-    <h3>Text Field</h3>
     <input id="text_field_id" name="text_field_name" class="text_field_class"
            size="40" type="text"/>
-    <h3>Hidden Field</h3>
     <input id="hidden_field_id" name="hidden_field_name" class="hidden_field_class"
            size="40" type="hidden" value="12345"/>
-    <h3>Text Area</h3>
     <textarea rows="2" cols="20" id="text_area_id" class="text_area_class" name="text_area_name"></textarea>
-    <h3>Select List</h3>
     <select name="sel_list_name" id="sel_list_id", class="sel_list_class">
     <option value="option1">Test 1</option>
     <option value="option2">Test 2</option>
     </select>
-    <h3>Link</h3>
     <a href="success.html" id="link_id" name="link_name" class="link_class">Google Search</a>
-    <h3>Check Boxes</h3>
     <input id="cb_id" name="cb_name" class="cb_class" type="checkbox" value="1"/>
-    <h3>Radio Buttons</h3>
     <input type="radio" id="milk_id" name="milk_name" class="milk_class" value="Milk"> Milk <br/>
     <input type="radio" id="butter_id" name="butter_name" class="butter_class" value="Butter">Butter
-    <h3>Div</h3>
     <div id="div_id" name="div_name" class="div_class">
         page-object rocks!
     </div>
-    <h3>Span</h3>
-        <span id="span_id" name="span_name" class="span_class">
-          My alert
-        </span>
+    <span id="span_id" name="span_name" class="span_class">
+      My alert
+    </span>
-    <h3>Table</h3>
     <table id='table_id' name='table_name' class='table_class' border='1'>
         <tr>
             <td>Data1</td>
@@ -57,45 +45,42 @@
         </tr>
     </table>
-    <h3>Button</h3>
     <form method="get" action="success.html">
         <input id='button_id' name='button_name' class='button_class' type="submit" value="Click Me">
     </form>
-    <h3>Image</h3>
     <img src="images/circle.png" id="image_id" name="image_name" class="image_class">
-    <h3>Form</h3>
     <form id="form_id" class="form_class" name="form_name" action="/">
     </form>
-    <h3>Unordered List</h3>
     <ul id="ul_id" name="ul_name" class="ul_class">
         <li id="li_id" name="li_name" class="li_class">Item One</li>
         <li>Item Two</li>
         <li>Item Three</li>
     </ul>
-    <h3>Ordered List</h3>
     <ol id="ol_id" name="ol_name" class="ol_class">
         <li>Number One</li>
         <li>Number Two</li>
         <li>Number Three</li>
     </ol>
-    <h3>Links for multi select</h3>
     <a href="success.html">Hello</a>
     <a href="success.html">Hello</a>
     <a href="success.html">Hello</a>
-    <h3>Alerts / Confirms / Prompts</h3>
     <input id=alert_button type=button onclick="alert('I am an alert')" value=Alert>
     <input id=confirm_button type=button onclick="this.value = confirm('set the value')" value=Confirm>
     <input id=prompt_button type=button onclick='this.value = prompt("enter your name", "John Doe")' value=Prompt>
-    <h3>New Window</h3>
+    <h1 id="h1_id" class="h1_class" name="h1_name">h1's are cool</h1>
+    <h2 id="h2_id" class="h2_class" name="h2_name">h2's are cool</h2>
+    <h3 id="h3_id" class="h3_class" name="h3_name">h3's are cool</h3>
+    <h4 id="h4_id" class="h4_class" name="h4_name">h4's are cool</h4>
+    <h5 id="h5_id" class="h5_class" name="h5_name">h5's are cool</h5>
+    <h6 id="h6_id" class="h6_class" name="h6_name">h6's are cool</h6>
     <a href="success.html" target="_blank">New Window</a>
   </body>
 </html>

data/features/nested_elements.feature CHANGED Viewed

@@ -1,4 +1,4 @@
-Feature: Attributes on Elements
+Feature: Nested Elements
   Background:
     Given I am on the nested elements page
@@ -71,3 +71,16 @@ Feature: Attributes on Elements
   Scenario: Finding a list item nested in an ordered list within a div
     When I search for a list item nested in an ordered list in a div
     Then I should see the nested list items text should be "Number One"
+  Scenario: Finding a h1 within a div
+    When I search for a h1 located list in a div
+    Then I should see the nested h1s text should be "h1's are cool"
+  Scenario: Finding a h2 within a div
+    When I search for a h2 located list in a div
+    Then I should see the nested h2s text should be "h2's are cool"
+  Scenario: Finding a h3 within a div
+    When I search for a h3 located list in a div
+    Then I should see the nested h3s text should be "h3's are cool"

data/features/step_definitions/element_steps.rb CHANGED Viewed

@@ -38,6 +38,10 @@ When /^I retrieve table cell$/ do
   @element = @page.cell_id_element
 end
+When /^I retrieve a heading element$/ do
+  @element = @page.h1_id_element
+end
 When /^I locate the form$/ do
   @element = @page.form_id_element
 end

data/features/step_definitions/headings_steps.rb ADDED Viewed

@@ -0,0 +1,12 @@
+When /^I get the text for the "([^\"]*)" element$/ do |el|
+  @heading = @page.send "#{el}_id"
+end
+Then /^I should see "([^\"]*)"$/ do |text|
+  @heading.should == text
+end
+When /^I search for the heading(\d+) by "([^"]*)"$/ do |head_type, type|
+  @heading = @page.send "h#{head_type}_#{type}"
+end

data/features/step_definitions/nested_elements_steps.rb CHANGED Viewed

@@ -19,6 +19,9 @@ class NestedElementsPage
   ordered_list(:nested_ordered_list) { |page| page.outer_div_element.ordered_list_element }
   unordered_list(:nested_unordered_list) { |page| page.outer_div_element.unordered_list_element }
   list_item(:nested_list_item) { |page| page.nested_ordered_list_element.list_item_element }
+  h1(:nested_h1) { |page| page.outer_div_element.h1_element}
+  h2(:nested_h2) { |page| page.outer_div_element.h2_element }
+  h3(:nested_h3) { |page| page.outer_div_element.h3_element }
 end
 Given /^I am on the nested elements page$/ do
@@ -163,3 +166,27 @@ end
 Then /^I should see the nested list items text should be "([^"]*)"$/ do |value|
   @li.text.should == value
 end
+When /^I search for a h1 located list in a div$/ do
+  @h1 = @page.nested_h1_element
+end
+Then /^I should see the nested h1s text should be "([^"]*)"$/ do |value|
+  @h1.text.should == value
+end
+When /^I search for a h2 located list in a div$/ do
+  @h2 = @page.nested_h2_element
+end
+Then /^I should see the nested h2s text should be "([^"]*)"$/ do |value|
+  @h2.text.should == value
+end
+When /^I search for a h3 located list in a div$/ do
+  @h3 = @page.nested_h3_element
+end
+Then /^I should see the nested h3s text should be "([^"]*)"$/ do |value|
+  @h3.text.should == value
+end

data/features/step_definitions/text_area_steps.rb CHANGED Viewed

@@ -25,3 +25,7 @@ end
 Then /^I should be able to type "([^"]*)" into the area element$/ do |value|
   @text_area.value = value
 end
+When /^I clear the text area$/ do
+  @page.text_area_id_element.clear
+end

data/features/support/page.rb CHANGED Viewed

@@ -163,6 +163,30 @@ class Page
   ordered_list(:ol_xpath, :xpath => '//ol')
   ordered_list(:ol_class_index, :class => "ol_class", :index => 0)
   ordered_list(:ol_name_index, :name => "ol_name", :index => 0)
+  h1(:h1_id, :id => 'h1_id')
+  h1(:h1_class, :class => 'h1_class')
+  h1(:h1_name, :name => 'h1_name')
+  h1(:h1_index, :index => 0)
+  h1(:h1_xpath, :xpath => '//h1')
+  h1(:h1_class_index, :class => 'h1_class', :index => 0)
+  h1(:h1_name_index, :name => 'h1_name', :index => 0)
+  h2(:h2_id, :id => 'h2_id')
+  h2(:h2_class, :class => 'h2_class')
+  h2(:h2_name, :name => 'h2_name')
+  h2(:h2_index, :index => 0)
+  h2(:h2_xpath, :xpath => '//h2')
+  h2(:h2_class_index, :class => 'h2_class', :index => 0)
+  h2(:h2_name_index, :name => 'h2_name', :index => 0)
+  h3(:h3_id, :id => 'h3_id')
+  h3(:h3_class, :class => 'h3_class')
+  h3(:h3_name, :name => 'h3_name')
+  h3(:h3_index, :index => 0)
+  h3(:h3_xpath, :xpath => '//h3')
+  h3(:h3_class_index, :class => 'h3_class', :index => 0)
+  h3(:h3_name_index, :name => 'h3_name', :index => 0)
   button(:alert_button, :id => 'alert_button')
   button(:confirm_button, :id => 'confirm_button')

data/features/text_area.feature CHANGED Viewed

@@ -35,3 +35,9 @@ Feature: Text Area
   Scenario: Finding a text area dynamically
     When I find a text area while the script is executing
     Then I should be able to type "I found it" into the area element
+  Scenario: Clearing the text area
+    When I type "abcdefghijklmnop" into the text area
+    Then the text area should contain "abcdefghijklmnop"
+    When I clear the text area
+    Then the text area should contain ""

data/lib/page-object/accessors.rb CHANGED Viewed

@@ -581,5 +581,92 @@ module PageObject
       end
       alias_method "#{name}_ordered_list".to_sym, "#{name}_element".to_sym
     end
+    #
+    # adds a method to retrieve the text of a h1 and a h1 element
+    #
+    # @example
+    #   h1(:title, :id => 'title')
+    #   # will generate a 'title' and 'title_element' method
+    #
+    # @param [String] the name used for the generated methods
+    # @param [Hash] identifier how we find a H1.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    # @param optional block to be invoked when element method is called
+    #
+    def h1(name, identifier=nil, &block)
+      define_method(name) do
+        return platform.h1_text_for identifier.clone unless block_given?
+        self.send("#{name}_element").text
+      end
+      define_method("#{name}_element") do
+        return call_block(&block) if block_given?
+        platform.h1_for(identifier.clone)
+      end
+      alias_method "#{name}_h1".to_sym, "#{name}_element".to_sym
+    end
+    #
+    # adds a method to retrieve the text of a h2 and a h2 element
+    #
+    # @example
+    #   h2(:title, :id => 'title')
+    #   # will generate a 'title' and 'title_element' method
+    #
+    # @param [String] the name used for the generated methods
+    # @param [Hash] identifier how we find a H2.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    # @param optional block to be invoked when element method is called
+    #
+    def h2(name, identifier=nil, &block)
+      define_method(name) do
+        return platform.h2_text_for identifier.clone unless block_given?
+        self.send("#{name}_element").text
+      end
+      define_method("#{name}_element") do
+        return call_block(&block) if block_given?
+        platform.h2_for(identifier.clone)
+      end
+      alias_method "#{name}_h2".to_sym, "#{name}_element".to_sym
+    end
+    #
+    # adds a method to retrieve the text of a h3 and a h3 element
+    #
+    # @example
+    #   h3(:title, :id => 'title')
+    #   # will generate a 'title' and 'title_element' method
+    #
+    # @param [String] the name used for the generated methods
+    # @param [Hash] identifier how we find a H3.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    # @param optional block to be invoked when element method is called
+    #
+    def h3(name, identifier=nil, &block)
+      define_method(name) do
+        return platform.h3_text_for identifier.clone unless block_given?
+        self.send("#{name}_element").text
+      end
+      define_method("#{name}_element") do
+        return call_block(&block) if block_given?
+        platform.h3_for(identifier.clone)
+      end
+      alias_method "#{name}_h3".to_sym, "#{name}_element".to_sym
+    end
   end
 end