page-object 0.0.2 → 0.0.3

data/ChangeLog

@@ -1,4 +1,21 @@
-=== Version 0.0.2
+== Version 0.0.3 / 2011-06-02
+* Enhancements
+  * Added support for the following elements
+    * span
+    * image
+    
+  * Added the following methods to Element
+    * value
+    * ==
+    * tag_name
+    * attribute
+    * click
+  
+  * Updated to use selenium-webdriver 0.2.1
+  
+  * Updated to use watir-webdriver 0.2.4
+
+=== Version 0.0.2 / 2011-05-30
 * Enhancements
   * Added support for the following elements
     * div
@@ -6,7 +23,8 @@
     * table
     * table row
     * table cell
-    * added #text to element
+    
+  * Added text method to element
 
 === Version 0.0.1 / 2011-05-22
 * Enhancements

data/features/div.feature

@@ -36,7 +36,7 @@ Feature: Div
     
     
   @selenium_only
-  Scenario Outline: Locating divs on Watir only
+  Scenario Outline: Locating divs on Selenium only
     When I search for the div by "<search_by>"
     Then the text should be "page-object rocks!"
 

data/features/element.feature

@@ -0,0 +1,160 @@
+Feature: Elements
+
+  Background:
+    Given I am on the static elements page
+
+  Scenario: Link element methods
+    When I retrieve a link element
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text is "Google Search"
+    And I should know it is equal to itself
+    And I should know its' tag name is "a"
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+    
+  @watir_only
+  Scenario: Link element methods for watir
+    When I retrieve a link element
+    Then I should know its' value is ""
+    
+
+  Scenario: Button element methods
+    When I retrieve a button element
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' value is "Click Me"
+    And I should know it is equal to itself
+    And I should know its' tag name is "input"
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+    
+  @watir_only
+  Scenario: Button element methods for watir
+    When I retrieve a button element
+    Then I should know its' text is "Click Me"
+
+  Scenario: Check Box element methods
+    When I retrieve a check box element
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text is ""
+    And I should know its' value is "1"
+    And I should know it is equal to itself
+    And I should know its' tag name is "input"
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+  
+  Scenario: Div element methods
+    When I retrieve the div element
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text is "page-object rocks!"
+    And I should know it is equal to itself
+    And I should know its' tag name is "div"
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+  @watir_only
+  Scenario: Div element methods for watir
+    When I retrieve the div element
+    Then I should know its' value is ""
+  
+  @selenium_only
+  Scenario: Div element methods for selenium
+    When I retrieve the div element
+    Then I should know its' value is nil
+
+  Scenario: Radio Button element methods
+    When I retrieve a radio button
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text is ""
+    And I should know its' value is "Milk"
+    And I should know it is equal to itself
+    And I should know its' tag name is "input"
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+  Scenario: Select List element methods
+    When I retrieve a select list
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text includes "Test 1"
+    And I should know its' value is "option1"
+    And I should know it is equal to itself
+    And I should know its' tag name is "select"      
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+  Scenario: Table element methods
+    When I retrieve a table element
+    Then I should know it is visible
+    And I should know its' text includes "Data1"
+    And I should know it is equal to itself
+    And I should know its' tag name is "table"      
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+  @watir_only
+  Scenario: Table element methods in watir
+    When I retrieve a table element
+    Then I should know it exists
+    And I should know its' value is ""
+  
+  @selenium_only
+  Scenario: Table element methods in selenium
+    When I retrieve a table element
+    Then I should know its' value is nil
+  
+  Scenario: Table Cell element methods
+    When I retrieve table cell
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text includes "Data4"
+    And I should know it is equal to itself
+    And I should know its' tag name is "td"      
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+  @watir_only
+  Scenario: Table Cell element methods in watir
+    When I retrieve table cell
+    Then I should know its' value is ""
+
+  @selenium_only
+  Scenario: Table Cell element methods in selenium
+    When I retrieve table cell
+    Then I should know its' value is nil
+
+  Scenario: Text Field element methods
+    When I retrieve a text field
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text includes ""
+    And I should know its' value is ""
+    And I should know it is equal to itself
+    And I should know its' tag name is "input"      
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+  Scenario: Image element methods
+    When I get the image element
+    Then I should know it exists
+    And I should know it is visible
+    And I should know its' text includes ""
+    And I should know it is equal to itself
+    And I should know its' tag name is "img"
+    And I should know the attribute "readonly" is false
+    And I should be able to click it
+
+    @watir_only
+    Scenario: Image element methods in watir
+      When I get the image element
+      Then I should know its' value is ""
+
+    @selenium_only
+    Scenario: Image element methods in selenium
+      When I get the image element
+      Then I should know its' value is nil
+

data/features/html/static_elements.html

@@ -32,6 +32,11 @@
       page-object rocks!
     </div>
     
+    <h3>Span</h3>
+    <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>
@@ -46,6 +51,9 @@
     <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">
   </body>
 </html>
 

data/features/image.feature

@@ -0,0 +1,32 @@
+Feature: Image
+
+  Background:
+    Given I am on the static elements page
+  
+  Scenario: Getting the image element
+    When I get the image element
+    Then the image should be "106" pixels wide
+    And the image should be "106" pixels tall
+
+  Scenario Outline: Locating an image on the page
+    When I get the image element by "<search_by>"
+    Then the image should be "106" pixels wide
+    And the image should be "106" pixels tall
+
+    Scenarios:
+      | search_by |
+      | id        |
+      | class     |
+      | name      |
+      | xpath     |  
+
+    @watir_only
+    Scenario Outline: Locating an image on the page with Watir
+      When I get the image element by "<search_by>"
+      Then the image should be "106" pixels wide
+      And the image should be "106" pixels tall
+
+    Scenarios:
+      | search_by |
+      | index     |
+

data/features/span.feature

@@ -0,0 +1,37 @@
+Feature: Span
+
+  Background:
+    Given I am on the static elements page
+  
+  Scenario: Getting the text from a span
+    When I get the text from the span
+    Then the text should be "My alert"
+
+  Scenario Outline: Locating spans on the page
+    When I search for the span by "<search_by>"
+    Then the text should be "My alert"
+
+  Scenarios:
+    | search_by |
+    | id        |
+    | class     |
+    | xpath     |  
+
+  @watir_only
+  Scenario Outline: Locating span on Watir only
+    When I search for the span by "<search_by>"
+    Then the text should be "My alert"
+
+  Scenarios:
+    | search_by |
+    | index     |
+    
+    
+  @selenium_only
+  Scenario Outline: Locating span on Watir only
+    When I search for the span by "<search_by>"
+    Then the text should be "My alert"
+
+  Scenarios:
+    | search_by |
+    | name      |

data/features/step_definitions/accessor_steps.rb

@@ -88,17 +88,26 @@ When /^I select the radio button$/ do
 end
 
 When /^I get the text from the div$/ do
-  @div_text = @page.div_id
+  @text = @page.div_id
 end
 
 Then /^the text should be "([^"]*)"$/ do |expected_text|
-  @div_text.should == expected_text
+  @text.should == expected_text
 end
 
 When /^I search for the div by "([^"]*)"$/ do |how|
-  @div_text = @page.send "div_#{how}".to_sym
+  @text = @page.send "div_#{how}".to_sym
 end
 
+When /^I get the text from the span$/ do
+  @text = @page.span_id
+end
+
+When /^I search for the span by "([^"]*)"$/ do |how|
+  @text = @page.send "span_#{how}".to_sym
+end
+
+
 When /^I click the button$/ do
   @page.button_id
 end
@@ -123,3 +132,20 @@ end
 When /^I retrieve a table element by "([^"]*)"$/ do |how|
   @element = @page.send "table_#{how}_table"
 end
+
+When /^I get the image element$/ do
+  @element = @page.image_id_image
+end
+
+Then /^the image should be "([^"]*)" pixels wide$/ do |width|
+  @element.width.should == width.to_i
+end
+
+Then /^the image should be "([^"]*)" pixels tall$/ do |height|
+  @element.height.should == height.to_i
+end
+
+When /^I get the image element by "([^"]*)"$/ do |how|
+  @element = @page.send "image_#{how}_image"
+end
+

data/features/step_definitions/element_steps.rb

@@ -44,3 +44,36 @@ Then /^I should know it is visible$/ do
   @element.should be_visible
 end
 
+Then /^I should know its' text is "([^"]*)"$/ do |text|
+  @element.text.should == text
+end
+
+Then /^I should know its' text includes "([^"]*)"$/ do |text|
+  @element.text.should include text
+end
+
+Then /^I should know its' value is "([^"]*)"$/ do |value|
+  @element.value.should == value
+end
+
+Then /^I should know its' value is nil$/ do
+  @element.value.should be_nil
+end
+
+Then /^I should know it is equal to itself$/ do
+  @element.should == @element
+end
+
+Then /^I should know its' tag name is "([^"]*)"$/ do |tagname|
+  @element.tag_name.should == tagname
+end
+
+Then /^I should know the attribute "([^"]*)" is false$/ do |attr_name|
+  @attr = @element.attribute(attr_name)
+  @attr.should be_false if @attr.is_a? FalseClass
+  @attr.should == "false" if @attr.is_a? String
+end
+
+Then /^I should be able to click it$/ do
+  @element.click
+end

data/features/support/page.rb

@@ -49,6 +49,12 @@ class Page
   div(:div_index, :index => 0)
   div(:div_xpath, :xpath => '//div')
   
+  span(:span_id, :id => 'span_id')
+  span(:span_name, :name => 'span_name')
+  span(:span_class, :class => 'span_class')
+  span(:span_index, :index => 0)
+  span(:span_xpath, :xpath => '//span')
+  
   table(:table_id, :id => 'table_id')
   table(:table_name, :name => 'table_name')
   table(:table_class, :class => 'table_class')
@@ -67,4 +73,11 @@ class Page
   button(:button_index, :index => 0)
   button(:button_xpath, :xpath=> "//input[@type='submit']")
   button(:button_text, :text => 'Click Me')
+  
+  image(:image_id, :id => 'image_id')
+  image(:image_name, :name => 'image_name')
+  image(:image_class, :class => 'image_class')
+  image(:image_index, :index => 0)
+  image(:image_xpath, :xpath => '//img')
+
 end

data/lib/page-object/accessors.rb

@@ -196,7 +196,7 @@ module PageObject
     # will generate a 'message' and 'message_div' methods
     #
     # @param the name used for the generated methods
-    # @param identifier how we find a checkbox.  The valid values are:
+    # @param identifier how we find a div.  The valid values are:
     #   :class => Watir and Selenium
     #   :id => Watir and Selenium
     #   :index => Watir only
@@ -204,7 +204,7 @@ module PageObject
     #   :xpath => Watir and Selenium
     #
     def div(name, identifier) 
-      define_method("#{name}") do
+      define_method(name) do
         platform.div_text_for identifier
       end
       define_method("#{name}_div") do
@@ -212,6 +212,30 @@ module PageObject
       end
     end
 
+    #
+    # adds two methods - one to retrieve the text from a span
+    # and another to return the span element
+    #
+    # Example:  span(:alert, {:id => 'alert'})
+    # will generate a 'alert' and 'alert_div' methods
+    #
+    # @param the name used for the generated methods
+    # @param identifier how we find a span.  The valid values are:
+    #   :class => Watir and Selenium
+    #   :id => Watir and Selenium
+    #   :index => Watir only
+    #   :name => Selenium only
+    #   :xpath => Watir and Selenium
+    #
+    def span(name, identifier)
+      define_method(name) do
+        platform.span_text_for identifier
+      end
+      define_method("#{name}_span") do
+        platform.span_for identifier
+      end
+    end
+
     #
     # adds a method to retrieve the table element
     #
@@ -255,5 +279,11 @@ module PageObject
         platform.cell_for identifier
       end
     end
+    
+    def image(name, identifier)
+      define_method("#{name}_image") do
+        platform.image_for identifier
+      end
+    end
   end
 end