page-object 0.6 → 0.6.1

data/ChangeLog

@@ -1,3 +1,13 @@
+=== Version 0.6.1 / 2012-1-18
+* Enhancements
+  * Added #disabled? method to Element
+  * Added #selected_options method to SelectList
+  * Added #include? and #selected? to SelectList
+  * Added #append to TextField
+  * generates a method to determine if an element exists (Thanks Nicholas Munson)
+  * better message when calling platform method via method_missing (Thanks Alex Rodionov)
+  * Updated to use selenium-webdriver 2.17.0
+
 === Version 0.6 / 2012-1-10
 * Enhancements
   * Added ?_elements methods to ElementLocator so you can find all elements that match an identifier

data/features/button.feature

@@ -82,5 +82,6 @@ Feature: Button
 
   Scenario: Finding a button dynamically
     When I find a button while the script is executing
-    Then I should be able to click the button element
+    Then I should see that the button exists
+    And I should be able to click the button element
   

data/features/check_box.feature

@@ -41,4 +41,5 @@ Feature: Check Box
       
   Scenario: Finding a check box dynamically
     When I select the first check box while the script is executing
-    Then the First check box should be selected
+    Then I should see that the checkbox exists
+    And the First check box should be selected

data/features/div.feature

@@ -39,4 +39,5 @@ Feature: Div
 
   Scenario: Finding a div dynamically
     When I get the text from a div while the script is executing
-    Then the text should be "page-object rocks!"
+    Then I should see that the div exists
+    And the text should be "page-object rocks!"

data/features/element.feature

@@ -12,8 +12,10 @@ Feature: Elements
   Scenario: Elements enabled?
     When I check an enabled button
     Then it should know it is enabled
+    And it should know that is it not disabled
     When I check a disabled button
     Then it should know it is not enabled
+    And it should know that it is disabled
 
   Scenario: Link element methods
     When I retrieve a link element

data/features/form.feature

@@ -30,4 +30,5 @@ Feature: Form
 
   Scenario: Finding a form dynamically
     When I locate a form while the script is executing
-    Then I should be able to submit the form
+    Then I should see that the form exists
+    And I should be able to submit the form

data/features/hidden_field.feature

@@ -9,7 +9,7 @@ Feature: Hidden Fields
 
   Scenario Outline: Locating hidden fields on the Page
     When I search for the hidden field by "<search_by>"
-    Then hidden field element should contains "12345"
+    Then the hidden field element should contain "12345"
 
   Scenarios:
     | search_by |
@@ -25,7 +25,7 @@ Feature: Hidden Fields
 
   Scenario Outline: Locating a hidden field using multiple parameters
     When I search for the hidden field by "<param1>" and "<param2>"
-    Then hidden field element should contains "12345"
+    Then the hidden field element should contain "12345"
 
   Scenarios:
     | param1 | param2 |
@@ -34,4 +34,5 @@ Feature: Hidden Fields
 
   Scenario: Finding a hidden field dynamically
     When I find a hidden field while the script is executing
-    Then hidden field element should contains "12345"
+    Then I should see that the hidden field exists
+    And the hidden field element should contain "12345"

data/features/image.feature

@@ -35,5 +35,6 @@ Feature: Image
 
   Scenario: Finding an image dynamically
     When I get the image element while the script is executing
-    Then the image should be "106" pixels wide
+    Then I should see that the image exists
+    And the image should be "106" pixels wide
     And the image should be "106" pixels tall

data/features/link.feature

@@ -39,4 +39,4 @@ Feature: Links
 
   Scenario: Finding a link dynamically
     When I select a link while the script is executing
-    Then the page should contain the text "Success"
+    And the page should contain the text "Success"

data/features/list_item.feature

@@ -30,4 +30,5 @@ Feature: List item
 
   Scenario: Finding a list item dynamically
     When I search for the list item while the script is executing
-    Then the text should be "Item One"
+    Then I should see that the list item exists
+    And the text should be "Item One"

data/features/ordered_list.feature

@@ -34,5 +34,6 @@ Feature: Ordered list
 
   Scenario: Finding a ordered list dynamically
     When I search for the ordered list while the script is executing
-    And I get the first item from the list
+    Then I should see that the ordered list exists
+    When I get the first item from the list
     Then the list items text should be "Number One"

data/features/paragraph.feature

@@ -30,4 +30,5 @@ Feature: Paragraph
 
   Scenario: Finding a paragraph dynamically
     When I get the text from a paragraph while the script is executing
-    Then the text should be "Static Elements Page"
+    Then I should see that the paragraph exists
+    And the text should be "Static Elements Page"

data/features/radio_button.feature

@@ -43,4 +43,5 @@ Feature: Radio Buttons
 
   Scenario: Finding a radio button dynamically
     When I select the radio button while the script is executing
-    Then the "Milk" radio button should be selected
+    Then I should see that the radio button exists
+    And the "Milk" radio button should be selected

data/features/select_list.feature

@@ -41,4 +41,17 @@ Feature: Select List
 
   Scenario: Finding a select list dynamically
     When I find a select list while the script is executing
-    Then I should be able to select "Test 2" from the list
+    Then I should see that the select list exists
+    And I should be able to select "Test 2" from the list
+
+  Scenario: Getting the selected option
+    When I select "Test 2" from the select list
+    Then the selected option should be "Test 2"
+
+  Scenario: Determining if a select list includes some option
+    Then the select list should include "Test 2"
+
+  Scenario: It should know if an option is selected
+    When I select "Test 2" from the select list
+    Then the select list should know that "Test 2" is selected
+

data/features/span.feature

@@ -31,4 +31,5 @@ Feature: Span
 
   Scenario: Finding a span dynamically
     When I get the text from a span while the script is executing
-    Then the text should be "My alert"
+    Then I should see that the span exists
+    And the text should be "My alert"

data/features/step_definitions/button_steps.rb

@@ -37,3 +37,7 @@ end
 Then /^I should be able to click the button element$/ do
   @button.click
 end
+
+Then /^I should see that the button exists$/ do
+  @page.button_id?.should == true
+end

data/features/step_definitions/check_box_steps.rb

@@ -29,3 +29,7 @@ end
 When /^I select the first check box while the script is executing$/ do
   @page.checkbox_element(:id => 'cb_id').check
 end
+
+Then /^I should see that the checkbox exists$/ do
+  @page.button_id?.should == true
+end

data/features/step_definitions/div_steps.rb

@@ -13,3 +13,7 @@ end
 When /^I get the text from a div while the script is executing$/ do
   @text = @page.div_element(:id => 'div_id').text
 end
+
+Then /^I should see that the div exists$/ do
+  @page.div_id?.should == true
+end

data/features/step_definitions/element_steps.rb

@@ -124,6 +124,14 @@ Then /^it should know it is not enabled$/ do
   @element.should_not be_enabled
 end
 
+Then /^it should know that is it not disabled$/ do
+  @element.should_not be_disabled
+end
+
+Then /^it should know that it is disabled$/ do
+  @element.should be_disabled
+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

data/features/step_definitions/form_steps.rb

@@ -13,3 +13,7 @@ end
 When /^I locate a form while the script is executing$/ do
   @element = @page.form_element(:id => 'form_id')
 end
+
+Then /^I should see that the form exists$/ do
+  @page.form_id?.should == true
+end

data/features/step_definitions/hidden_field_steps.rb

@@ -10,7 +10,7 @@ When /^I search for the hidden field by "([^\"]*)"$/ do |how|
   @element = @page.send "hidden_field_#{how}_element"
 end
 
-Then /^hidden field element should contains "([^\"]*)"$/ do |text|
+Then /^the hidden field element should contain "([^\"]*)"$/ do |text|
   @element.value.should == text
 end
 
@@ -21,3 +21,7 @@ end
 When /^I find a hidden field while the script is executing$/ do
   @element = @page.hidden_field_element(:id => 'hidden_field_id')
 end
+
+Then /^I should see that the hidden field exists$/ do
+  @page.hidden_field_id?.should == true
+end

data/features/step_definitions/image_steps.rb

@@ -21,3 +21,7 @@ end
 When /^I get the image element while the script is executing$/ do
   @element = @page.image_element(:id => 'image_id')
 end
+
+Then /^I should see that the image exists$/ do
+  @page.image_id?.should == true
+end

data/features/step_definitions/link_steps.rb

@@ -18,3 +18,9 @@ When /^I select a link while the script is executing$/ do
   link = @page.link_element(:id => 'link_id')
   link.click
 end
+
+Then /^I should see that the link exists$/ do
+  require 'ruby-debug'
+  debugger
+  @page.link_id?.should == true
+end

data/features/step_definitions/list_item_steps.rb

@@ -13,3 +13,7 @@ end
 When /^I search for the list item while the script is executing$/ do
   @text = @page.list_item_element(:id => 'li_id').text
 end
+
+Then /^I should see that the list item exists$/ do
+  @page.li_id?.should == true
+end

data/features/step_definitions/ordered_list_steps.rb

@@ -13,3 +13,7 @@ end
 When /^I search for the ordered list while the script is executing$/ do
   @list = @page.ordered_list_element(:id => 'ol_id')
 end
+
+Then /^I should see that the ordered list exists$/ do
+  @page.ol_id?.should == true
+end

data/features/step_definitions/paragraph_steps.rb

@@ -14,3 +14,7 @@ end
 When /^I get the text from a paragraph while the script is executing$/ do
   @text = @page.paragraph_element(:id => 'p_id').text
 end
+
+Then /^I should see that the paragraph exists$/ do
+  @page.p_id?.should == true
+end

data/features/step_definitions/radio_button_steps.rb

@@ -21,3 +21,7 @@ end
 When /^I select the radio button while the script is executing$/ do
   @page.radio_button_element(:id => 'milk_id').select
 end
+
+Then /^I should see that the radio button exists$/ do
+  @page.milk_id?.should == true
+end

data/features/step_definitions/select_list_steps.rb

@@ -23,6 +23,23 @@ When /^I find a select list while the script is executing$/ do
   @select_list = @page.select_list_element(:id => 'sel_list_id')
 end
 
-Then /^I should be able to select "([^"]*)" from the list$/ do |value|
+Then /^I should be able to select "([^\"]*)" from the list$/ do |value|
   @select_list.select(value)
 end
+
+Then /^I should see that the select list exists$/ do
+  @page.sel_list_id?.should == true
+end
+
+Then /^the selected option should be "([^\"]*)"$/ do |text|
+  @page.select_list_element(:id => 'sel_list_id').selected_options[0].should == text
+end
+
+Then /^the select list should include "([^\"]*)"$/ do |text|
+  @page.sel_list_id_element.should include text
+end
+
+Then /^the select list should know that "([^\"]*)" is selected$/ do |text|
+  @page.sel_list_id_element.selected?(text).should be_true
+end
+

data/features/step_definitions/span_steps.rb

@@ -13,3 +13,7 @@ end
 When /^I get the text from a span while the script is executing$/ do
   @text = @page.span_element(:id => 'span_id').text
 end
+
+Then /^I should see that the span exists$/ do
+  @page.span_id?.should == true
+end

data/features/step_definitions/table_cell_steps.rb

@@ -9,3 +9,7 @@ end
 When /^I retrieve a table cell element while the script is executing$/ do
   @cell_data = @page.cell_element(:id => 'cell_id').text
 end
+
+Then /^I should see that the cell exists$/ do
+  @page.cell_id?.should == true
+end

data/features/step_definitions/table_steps.rb

@@ -34,3 +34,7 @@ Then /^the data for the last row should be "([^\"]*)" and "([^\"]*)"$/ do |col1,
   @element.last_row[0].text.should == col1
   @element.last_row[1].text.should == col2
 end
+
+Then /^I should see that the table exists$/ do
+  @page.table_id?.should == true
+end

data/features/step_definitions/text_area_steps.rb

@@ -29,3 +29,7 @@ end
 When /^I clear the text area$/ do
   @page.text_area_id_element.clear
 end
+
+Then /^I should see that the text area exists$/ do
+  @page.text_area_id?.should == true
+end

data/features/step_definitions/text_field_steps.rb

@@ -22,6 +22,14 @@ When /^I find a text field while the script is executing$/ do
   @text_field = @page.text_field_element(:id => 'text_field_id')
 end
 
-Then /^I should be able to type "([^"]*)" into the field element$/ do |value|
+Then /^I should be able to type "([^\"]*)" into the field element$/ do |value|
   @text_field.value = value
 end
+
+Then /^I should see that the text field exists$/ do
+  @page.text_field_id?.should == true
+end
+
+When /^I append "([^\"]*)" to the text field$/ do |text|
+  @page.text_field_id_element.append text
+end

data/features/step_definitions/unordered_list_steps.rb

@@ -14,3 +14,6 @@ When /^I search for the unordered list while the script is executing$/ do
   @list = @page.unordered_list_element(:id => 'ul_id')
 end
 
+Then /^I should see that the unordered list exists$/ do
+  @page.ul_id?.should == true
+end

data/features/table.feature

@@ -49,4 +49,8 @@ Feature: Table
 
   Scenario: Finding a table dynamically
     When I retrieve a table element while the script is executing
-    Then the data for row "1" should be "Data1" and "Data2"
+    And the data for row "1" should be "Data1" and "Data2"
+
+  @watir_only
+  Scenario: Finding an existing table
+    Then I should see that the table exists

data/features/table_cell.feature

@@ -40,4 +40,5 @@ Feature: Table Cell
 
   Scenario: Finding a table cell dynamically
     When I retrieve a table cell element while the script is executing
-    Then the cell data should be 'Data4'
+    Then I should see that the cell exists
+    And the cell data should be 'Data4'

data/features/text_area.feature

@@ -34,7 +34,8 @@ 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
+    Then I should see that the text area exists
+    And 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

data/features/text_field.feature

@@ -41,4 +41,11 @@ Feature: Text Fields
 
   Scenario: Finding a text field dynamically
     When I find a text field while the script is executing
-    Then I should be able to type "I found it" into the field element
+    Then I should see that the text field exists
+    And I should be able to type "I found it" into the field element
+
+  Scenario: Appending text to a text field
+    When I type "abcd" into the text field
+    And I append "efg" to the text field
+    Then the text field should contain "abcdefg"
+

data/features/unordered_list.feature

@@ -34,5 +34,6 @@ Feature: Unordered list
 
   Scenario: Finding a unordered list dynamically
     When I search for the unordered list while the script is executing
-    And I get the first item from the list
+    Then I should see that the unordered list exists
+    When I get the first item from the list
     Then the list items text should be "Item One"

data/lib/page-object/accessors.rb

@@ -45,13 +45,14 @@ module PageObject
     end
 
     #
-    # adds three methods to the page object - one to set text in a text field,
-    # another to retrieve text from a text field and another to return the text
-    # field element.
+    # adds four methods to the page object - one to set text in a text field,
+    # another to retrieve text from a text field, another to return the text
+    # field element, another to check the text field's existence.
     #
     # @example  
     #   text_field(:first_name, :id => "first_name") 
-    #   # will generate 'first_name', 'first_name=' and 'first_name_element' methods
+    #   # will generate 'first_name', 'first_name=', 'first_name_element',
+    #   # 'first_name?' methods
     #
     # @param  [String] the name used for the generated methods
     # @param [Hash] identifier how we find a text field.  You can use a multiple paramaters
@@ -81,16 +82,21 @@ module PageObject
         return call_block(&block) if block_given?
         platform.text_field_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.text_field_for(identifier.clone).exists?
+      end
       alias_method "#{name}_text_field".to_sym, "#{name}_element".to_sym
     end
     
     #
-    # adds two methods to the page object - one to get the text from a hidden field
-    # and another to retrieve the hidden field element.
+    # adds three methods to the page object - one to get the text from a hidden field,
+    # another to retrieve the hidden field element, and another to check the hidden
+    # field's existence.
     #
     # @example
     #   hidden_field(:user_id, :id => "user_identity")
-    #   # will generate 'user_id' and 'user_id_element' methods
+    #   # will generate 'user_id', 'user_id_element' and 'user_id?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a hidden field.  You can use a multiple paramaters
@@ -115,17 +121,22 @@ module PageObject
         return call_block(&block) if block_given?
         platform.hidden_field_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.hidden_field_for(identifier.clone).exists?
+      end
       alias_method "#{name}_hidden_field".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds three methods to the page object - one to set text in a text area,
-    # another to retrieve text from a text area and another to return the text
-    # area element.
+    # adds four methods to the page object - one to set text in a text area,
+    # another to retrieve text from a text area, another to return the text
+    # area element, and another to check the text area's existence.
     #
     # @example
     #   text_area(:address, :id => "address")
-    #   # will generate 'address', 'address=' and 'address_element methods
+    #   # will generate 'address', 'address=', 'address_element',
+    #   # 'address?' methods
     #
     # @param  [String] the name used for the generated methods
     # @param [Hash] identifier how we find a text area.  You can use a multiple paramaters
@@ -152,17 +163,22 @@ module PageObject
         return call_block(&block) if block_given?
         platform.text_area_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.text_area_for(identifier.clone).exists?
+      end
       alias_method "#{name}_text_area".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds three methods - one to select an item in a drop-down,
-    # another to fetch the currently selected item and another
-    # to retrieve the select list element.
+    # adds four methods - one to select an item in a drop-down,
+    # another to fetch the currently selected item, another
+    # to retrieve the select list element, and another to check the 
+    # drop down's existence.
     #
     # @example
     #   select_list(:state, :id => "state")
-    #   # will generate 'state', 'state=' and 'state_element' methods
+    #   # will generate 'state', 'state=', 'state_element', 'state?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a select list.  You can use a multiple paramaters
@@ -189,17 +205,21 @@ module PageObject
         return call_block(&block) if block_given?
         platform.select_list_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.select_list_for(identifier.clone).exists?
+      end
       alias_method "#{name}_select_list".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds two methods - one to select a link and another
+    # adds three methods - one to select a link, another
     # to return a PageObject::Elements::Link object representing
-    # the link.
+    # the link, and another that checks the link's existence.
     #
     # @example
     #   link(:add_to_cart, :text => "Add to Cart")
-    #   # will generate 'add_to_cart' and 'add_to_cart_element' methods
+    #   # will generate 'add_to_cart', 'add_to_cart_element', and 'add_to_cart?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a link.  You can use a multiple paramaters
@@ -224,17 +244,23 @@ module PageObject
         return call_block(&block) if block_given?
         platform.link_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.link_for(identifier.clone).exists?
+      end
       alias_method "#{name}_link".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds four methods - one to check, another to uncheck, another
-    # to return the state of a checkbox, and a final method to return
-    # a PageObject::Elements::CheckBox object representing the checkbox.
+    # adds five methods - one to check, another to uncheck, another
+    # to return the state of a checkbox, another to return
+    # a PageObject::Elements::CheckBox object representing the checkbox, and
+    # a final method to check the checkbox's existence.
     #
     # @example
     #   checkbox(:active, :name => "is_active")
-    #   # will generate 'check_active', 'uncheck_active', 'active_checked?' and 'active_element' methods
+    #   # will generate 'check_active', 'uncheck_active', 'active_checked?', 
+    #   # 'active_element', and 'active?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a checkbox.  You can use a multiple paramaters
@@ -264,18 +290,24 @@ module PageObject
         return call_block(&block) if block_given?
         platform.checkbox_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.checkbox_for(identifier.clone).exists?
+      end
       alias_method "#{name}_checkbox".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds four methods - one to select, another to clear,
-    # another to return if a radio button is selected, and
+    # adds five methods - one to select, another to clear,
+    # another to return if a radio button is selected, 
     # another method to return a PageObject::Elements::RadioButton
-    # object representing the radio button element
+    # object representing the radio button element, and another to check
+    # the radio button's existence.
     #
     # @example
     #   radio_button(:north, :id => "north")
-    #   # will generate 'select_north', 'clear_north', 'north_selected?' and 'north_element' methods
+    #   # will generate 'select_north', 'clear_north', 'north_selected?', 
+    #   # 'north_element', and 'north?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a radio button.  You can use a multiple paramaters
@@ -305,16 +337,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.radio_button_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.radio_button_for(identifier.clone).exists?
+      end
       alias_method "#{name}_radio_button".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds two methods - one to click a button and another to
-    # return the button element.
+    # adds three methods - one to click a button, another to
+    # return the button element, and another to check the button's existence.
     #
     # @example
     #   button(:purchase, :id => 'purchase')
-    #   # will generate 'purchase' and 'purchase_element' methods
+    #   # will generate 'purchase', 'purchase_element', and 'purchase?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a button.  You can use a multiple paramaters
@@ -339,16 +375,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.button_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.button_for(identifier.clone).exists?
+      end
       alias_method "#{name}_button".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds two methods - one to retrieve the text from a div
-    # and another to return the div element
+    # adds three methods - one to retrieve the text from a div,
+    # another to return the div element, and another to check the div's existence.
     #
     # @example
     #   div(:message, :id => 'message')
-    #   # will generate 'message' and 'message_element' methods
+    #   # will generate 'message', 'message_element', and 'message?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a div.  You can use a multiple paramaters
@@ -370,16 +410,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.div_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.div_for(identifier.clone).exists?
+      end
       alias_method "#{name}_div".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds two methods - one to retrieve the text from a span
-    # and another to return the span element
+    # adds three methods - one to retrieve the text from a span,
+    # another to return the span element, and another to check the span's existence.
     #
     # @example
     #   span(:alert, :id => 'alert')
-    #   # will generate 'alert' and 'alert_element' methods
+    #   # will generate 'alert', 'alert_element', and 'alert?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a span.  You can use a multiple paramaters
@@ -400,15 +444,21 @@ module PageObject
         return call_block(&block) if block_given?
         platform.span_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.span_for(identifier.clone).exists?
+      end
       alias_method "#{name}_span".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the table element
+    # adds two methods - one to retrieve the table element, and another to
+    # check the table's existence.  The existence method does not work
+    # on Selenium so it should not be called.
     #
     # @example
     #   table(:cart, :id => 'shopping_cart')
-    #   # will generate a 'cart_element' method
+    #   # will generate a 'cart_element' and 'cart?' method
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a table.  You can use a multiple paramaters
@@ -425,16 +475,21 @@ module PageObject
         return call_block(&block) if block_given?
         platform.table_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.table_for(identifier.clone).exists?
+      end
       alias_method "#{name}_table".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds two methods  one to retrieve the text from a table cell
-    # and another to return the table cell element
+    # adds three methods - one to retrieve the text from a table cell,
+    # another to return the table cell element, and another to check the cell's
+    # existence.
     #
     # @example
     #   cell(:total, :id => 'total_cell')
-    #   # will generate 'total' and 'total_element' methods
+    #   # will generate 'total', 'total_element', and 'total?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a cell.  You can use a multiple paramaters
@@ -456,15 +511,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.cell_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.cell_for(identifier.clone).exists?
+      end
       alias_method "#{name}_cell".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the image element
+    # adds two methods - one to retrieve the image element, and another to
+    # check the image's existence.
     #
     # @example
     #   image(:logo, :id => 'logo')
-    #   # will generate a 'logo_element' method
+    #   # will generate 'logo_element' and 'logo?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an image.  You can use a multiple paramaters
@@ -483,15 +543,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.image_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.image_for(identifier.clone).exists?
+      end
       alias_method "#{name}_image".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the form element
+    # adds two methods - one to retrieve the form element, and another to
+    # check the form's existence.
     #
     # @example
     #   form(:login, :id => 'login')
-    #   # will generate a 'login_element' method
+    #   # will generate 'login_element' and 'login?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a form.  You can use a multiple paramaters
@@ -508,16 +573,21 @@ module PageObject
         return call_block(&block) if block_given?
         platform.form_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.form_for(identifier.clone).exists?
+      end
       alias_method "#{name}_form".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds two methods - one to retrieve the text from a list item
-    # and another to return the list item element
+    # adds three methods - one to retrieve the text from a list item,
+    # another to return the list item element, and another to check the list item's
+    # existence.
     #
     # @example
     #   list_item(:item_one, :id => 'one')
-    #   # will generate 'item_one' and 'item_one_element' methods
+    #   # will generate 'item_one', 'item_one_element', and 'item_one?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a list item.  You can use a multiple paramaters
@@ -538,15 +608,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.list_item_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.list_item_for(identifier.clone).exists?
+      end
       alias_method "#{name}_list_item".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the unordered list element
+    # adds two methods - one to retrieve the unordered list element, and another to
+    # check it's existence.
     #
     # @example
     #   unordered_list(:menu, :id => 'main_menu')
-    #   # will generate a 'menu_element' method
+    #   # will generate 'menu_element' and 'menu?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an unordered list.  You can use a multiple paramaters
@@ -563,15 +638,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.unordered_list_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.unordered_list_for(identifier.clone).exists?
+      end
       alias_method "#{name}_unordered_list".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the ordered list element
+    # adds two methods - one to retrieve the ordered list element, and another to
+    # test it's existence.
     #
     # @example
     #   ordered_list(:top_five, :id => 'top')
-    #   # will generate a 'top_five_element' method
+    #   # will generate 'top_five_element' and 'top_five?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an ordered list.  You can use a multiple paramaters
@@ -588,15 +668,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.ordered_list_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.ordered_list_for(identifier.clone).exists?
+      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
+    # adds three methods - one to retrieve the text of a h1 element, another to 
+    # retrieve a h1 element, and another to check for it's existence.
     #
     # @example
     #   h1(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a H1.  You can use a multiple paramaters
@@ -617,15 +702,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.h1_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.h1_for(identifier.clone).exists?
+      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
+    # adds three methods - one to retrieve the text of a h2 element, another
+    # to retrieve a h2 element, and another to check for it's existence.
     #
     # @example
     #   h2(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a H2.  You can use a multiple paramaters
@@ -646,15 +736,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.h2_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.h2_for(identifier.clone).exists?
+      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
+    # adds three methods - one to retrieve the text of a h3 element,
+    # another to return a h3 element, and another to check for it's existence.
     #
     # @example
     #   h3(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a H3.  You can use a multiple paramaters
@@ -675,15 +770,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.h3_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.h3_for(identifier.clone).exists?
+      end
       alias_method "#{name}_h3".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the text of a h4 and a h4 element
+    # adds three methods - one to retrieve the text of a h4 element,
+    # another to return a h4 element, and another to check for it's existence.
     #
     # @example
     #   h4(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a H4.  You can use a multiple paramaters
@@ -704,15 +804,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.h4_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.h4_for(identifier.clone).exists?
+      end
       alias_method "#{name}_h4".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the text of a h5 and a h5 element
+    # adds three methods - one to retrieve the text of a h5 element,
+    # another to return a h5 element, and another to check for it's existence.
     #
     # @example
     #   h5(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a H5.  You can use a multiple paramaters
@@ -733,15 +838,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.h5_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.h5_for(identifier.clone).exists?
+      end
       alias_method "#{name}_h5".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the text of a h6 and a h6 element
+    # adds three methods - one to retrieve the text of a h6 element,
+    # another to return a h6 element, and another to check for it's existence.
     #
     # @example
     #   h6(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a H6.  You can use a multiple paramaters
@@ -762,15 +872,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.h6_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.h6_for(identifier.clone).exists?
+      end
       alias_method "#{name}_h6".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to retrieve the text of a paragraph and a paragraph element
+    # adds three methods - one to retrieve the text of a paragraph, another
+    # to retrieve a paragraph element, and another to check the paragraph's existence.
     #
     # @example
     #   paragraph(:title, :id => 'title')
-    #   # will generate a 'title' and 'title_element' method
+    #   # will generate 'title', 'title_element', and 'title?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a paragraph.  You can use a multiple paramaters
@@ -791,16 +906,20 @@ module PageObject
         return call_block(&block) if block_given?
         platform.paragraph_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.paragraph_for(identifier.clone).exists?
+      end
       alias_method "#{name}_paragraph".to_sym, "#{name}_element".to_sym
     end
 
     #
-    # adds a method to set the file for a file field and to retrieve
-    # the file field element
+    # adds three methods - one to set the file for a file field, another to retrieve
+    # the file field element, and another to check it's existence.
     #
     # @example
     #   file_field(:the_file, :id => 'file_to_upload')
-    #   # will generate a 'the_file=' and 'the_file_element' method
+    #   # will generate 'the_file=', 'the_file_element', and 'the_file?' methods
     #
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a file_field.  You can use a multiple paramaters
@@ -822,6 +941,10 @@ module PageObject
         return call_block(&block) if block_given?
         platform.file_field_for(identifier.clone)
       end
+      define_method("#{name}?") do
+        return call_block(&block).exists? if block_given?
+        platform.file_field_for(identifier.clone).exists?
+      end
     end
   end
 end