page-object 0.0.5 → 0.1

data/features/step_definitions/element_steps.rb

@@ -1,3 +1,8 @@
+When /^I select a link labeled "([^"]*)" and index "([^"]*)"$/ do |label, index|
+  @page.send "#{label.downcase}#{index}".to_sym
+end
+
+
 When /^I retrieve a check box element$/ do
   @element = @page.cb_id_checkbox
 end

data/features/support/page.rb

@@ -1,6 +1,10 @@
 class Page
   include PageObject
 
+  link(:hello0, {:text => "Hello", :index => 0})
+  link(:hello1, {:text => "Hello", :index => 1})
+  link(:hello2, {:text => "Hello", :index => 2})
+
   text_field(:text_field_id, :id => "text_field_id")
   text_field(:text_field_class, :class => "text_field_class")
   text_field(:text_field_name, :name => "text_field_name")
@@ -10,6 +14,8 @@ class Page
   text_field(:text_field_index, :index => 0)
   text_field(:text_field_text, :text => "")
   text_field(:text_field_value, :value => "")
+  text_field(:text_field_class_index, :class => "text_field_class", :index => 0)
+  text_field(:text_field_name_index, :name => "text_field_name", :index => 0)
 
   text_area(:text_area_id, :id => "text_area_id")
   text_area(:text_area_class, :class => "text_area_class")
@@ -20,6 +26,8 @@ class Page
   text_area(:text_area_index, :index => 0)
   text_area(:text_area_text, :text => "")
   text_area(:text_area_value, :value => "")
+  text_area(:text_area_class_index, :class => "text_area_class", :index => 0)
+  text_area(:text_area_name_index, :name => "text_area_name", :index => 0)
 
   hidden_field(:hidden_field_id, :id => "hidden_field_id")
   hidden_field(:hidden_field_class, :class => "hidden_field_class")
@@ -30,6 +38,8 @@ class Page
   hidden_field(:hidden_field_index, :index => 0)
   hidden_field(:hidden_field_text, :text => "")
   hidden_field(:hidden_field_value, :value => "")
+  hidden_field(:hidden_field_class_index, :class => "hidden_field_class", :index => 0)
+  hidden_field(:hidden_field_name_index, :name => "hidden_field_name", :index => 0)
 
   link(:google_search_id, :id => "link_id")
   link(:google_search_name, :name => "link_name")
@@ -48,18 +58,24 @@ class Page
   select_list(:sel_list_value, :value => "option1")
   select_list(:sel_list_xpath, :xpath => "//select")
   select_list(:sel_list_text, :text => "Test 1")
+  select_list(:sel_list_class_index, :class => "sel_list_class", :index => 0)
+  select_list(:sel_list_name_index, :name => "sel_list_name", :index => 0)
 
   checkbox(:cb_id, :id => 'cb_id')
   checkbox(:cb_name, :name => 'cb_name')
   checkbox(:cb_class, :class => 'cb_class')
   checkbox(:cb_index, :index => 0)
   checkbox(:cb_xpath, :xpath => "//input[@type='checkbox']")
+  checkbox(:cb_class_index, :class => "cb_class", :index => 0)
+  checkbox(:cb_name_index, :name => "cb_name", :index => 0)
 
   radio_button(:milk_id, :id => 'milk_id')
   radio_button(:milk_name, :name => 'milk_name')
   radio_button(:milk_class, :class => 'milk_class')
   radio_button(:milk_index, :index => 0)
   radio_button(:milk_xpath, :xpath => "//input[@type='radio']")
+  radio_button(:milk_class_index, :class => "milk_class", :index => 0)
+  radio_button(:milk_name_index, :name => "milk_name", :index => 0)
   
   radio_button(:butter_id, :id => 'butter_id')
   
@@ -68,24 +84,32 @@ class Page
   div(:div_class, :class => 'div_class')
   div(:div_index, :index => 0)
   div(:div_xpath, :xpath => '//div')
+  div(:div_class_index, :class => "div_class", :index => 0)
+  div(:div_name_index, :name => "div_name", :index => 0)
   
   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')
+  span(:span_class_index, :class => "span_class", :index => 0)
+  span(:span_name_index, :name => "span_name", :index => 0)
   
   table(:table_id, :id => 'table_id')
   table(:table_name, :name => 'table_name')
   table(:table_class, :class => 'table_class')
   table(:table_index, :index => 0)
   table(:table_xpath, :xpath => '//table')
+  table(:table_class_index, :class => "table_class", :index => 0)
+  table(:table_name_index, :name => "table_name", :index => 0)
   
   cell(:cell_id, :id => 'cell_id')
   cell(:cell_name, :name => 'cell_name')
   cell(:cell_class, :class => 'cell_class')
   cell(:cell_index, :index => 3)
   cell(:cell_xpath, :xpath => '//table//tr[2]//td[2]')
+  cell(:cell_class_index, :class => "cell_class", :index => 0)
+  cell(:cell_name_index, :name => "cell_name", :index => 0)
   
   button(:button_id, :id => 'button_id')
   button(:button_name, :name => 'button_name')
@@ -93,34 +117,46 @@ class Page
   button(:button_index, :index => 0)
   button(:button_xpath, :xpath=> "//input[@type='submit']")
   button(:button_text, :text => 'Click Me')
+  button(:button_class_index, :class => "button_class", :index => 0)
+  button(:button_name_index, :name => "button_name", :index => 0)
   
   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')
+  image(:image_class_index, :class => "image_class", :index => 0)
+  image(:image_name_index, :name => "image_name", :index => 0)
 
   form(:form_id, :id => 'form_id')
   form(:form_name, :id => 'form_name')
   form(:form_class, :class => 'form_class')
   form(:form_index, :index => 0)
   form(:form_xpath, :xpath => '//form')
+  form(:form_class_index, :class => "form_class", :index => 0)
+  form(:form_name_index, :name => "form_name", :index => 0)
   
   list_item(:li_id, :id => 'li_id')
   list_item(:li_name, :name => 'li_name')
   list_item(:li_class, :class => 'li_class')
   list_item(:li_index, :index => 0)
   list_item(:li_xpath, :xpath => '//li[1]')
+  list_item(:li_class_index, :class => "li_class", :index => 0)
+  list_item(:li_name_index, :name => "li_name", :index => 0)
   
   unordered_list(:ul_id, :id => 'ul_id')
   unordered_list(:ul_name, :name => 'ul_name')
   unordered_list(:ul_class, :class => 'ul_class')
   unordered_list(:ul_index, :index => 0)
   unordered_list(:ul_xpath, :xpath => '//ul')
+  unordered_list(:ul_class_index, :class => "ul_class", :index => 0)
+  unordered_list(:ul_name_index, :name => "ul_name", :index => 0)
 
   ordered_list(:ol_id, :id => 'ol_id')
   ordered_list(:ol_name, :name => 'ol_name')
   ordered_list(:ol_class, :class => 'ol_class')
   ordered_list(:ol_index, :index => 0)
   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)
 end

data/features/table.feature

@@ -33,23 +33,14 @@ Feature: Table
     | id        |
     | class     |
     | xpath     |  
-  
-  
-  @watir_only
-  Scenario Outline: Locating table cells on the Page with watir
-    When I retrieve a table element by "<search_by>"
-    Then the data for row "1" should be "Data1" and "Data2"
-
-  Scenarios:
-    | search_by |
     | index     |
+    | name      |
 
-
-  @selenium_only
-  Scenario Outline: Locating table cells on the Page with selenium
-    When I retrieve a table element by "<search_by>"
+  Scenario Outline: Locating table using multiple parameters
+    When I retrieve a table element by "<param1>" and "<param2>"
     Then the data for row "1" should be "Data1" and "Data2"
 
   Scenarios:
-    | search_by |
-    | name      |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/table_cell.feature

@@ -17,8 +17,8 @@ Feature: Table Cell
     | id        |
     | class     |
     | xpath     |  
+    | name      |
   
-
   @watir_only
   Scenario Outline: Locating table cells on the Page with watir
     When I search for the table cell by "<search_by>"
@@ -28,18 +28,12 @@ Feature: Table Cell
     | search_by |
     | index     |
 
-  @selenium_only
-  Scenario Outline: Locating table cells on the Page with watir
-    When I search for the table cell by "<search_by>"
+  Scenario Outline: Locating table cell using multiple parameters
+    When I retrieve a table cell element by "<param1>" and "<param2>"
     Then the cell data should be 'Data4'
 
   Scenarios:
-    | search_by |
-    | name      |
-
-  Scenario: Retrieve a cell from a table by id
-    When I retrieve table cell
-    Then I should know it exists
-    And I should know it is visible
-
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
 

data/features/text_area.feature

@@ -20,13 +20,14 @@ Feature: Text Area
     | xpath     |  
     | css       |
     | tag_name  |
+    | index     |
 
-  @watir_only
-  Scenario Outline: Locating text fields on Watir only
-    When I search for the text area by "<search_by>"
+
+  Scenario Outline: Locating a text area using multiple parameters
+    When I search for the text area by "<param1>" and "<param2>"
     Then I should be able to type "I found it" into the area
 
   Scenarios:
-    | search_by |
-    | index     |
-
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/text_field.feature

@@ -22,15 +22,16 @@ Feature: Text Fields
     | xpath     |  
     | css       |
     | tag_name  |
-
-  @watir_only
-  Scenario Outline: Locating text fields on Watir only
-    When I search for the text field by "<search_by>"
+    | index     |
+    
+  Scenario Outline: Locating a text field using multiple parameters
+    When I search for the text field by "<param1>" and "<param2>"
     Then I should be able to type "I found it" into the field
 
   Scenarios:
-    | search_by |
-    | index     |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
 
   Scenario: Retrieve a text field
     When I retrieve a text field

data/features/unordered_list.feature

@@ -5,12 +5,12 @@ Feature: Unordered list
   
   Scenario: Getting the first element from the unordered list
     When I get the first item from the unordered list
-    Then the list item's text should be "Item One"
+    Then the list items text should be "Item One"
 
   Scenario Outline: Locating unordered lists on the page
     When I search for the unordered list by "<search_by>"
     And I get the first item from the list
-    Then the list item's text should be "Item One"
+    Then the list items text should be "Item One"
     And the list should contain 3 items
     And each item should contain "Item"
   
@@ -19,23 +19,15 @@ Feature: Unordered list
     | id        |
     | class     |
     | xpath     |  
-
-  @watir_only
-  Scenario Outline: Locating unordered lists in Watir only
-    When I search for the unordered list by "<search_by>"
-    And I get the first item from the list
-    Then the list item's text should be "Item One"
-
-  Scenarios:
-    | search_by |
     | index     |
+    | name      |
 
-  @selenium_only
-  Scenario Outline: Locating unordered lists in Selenium only
-    When I search for the unordered list by "<search_by>"
+  Scenario Outline: Locating unordered lists using multiple parameters
+    When I search for the unordered list by "<param1>" and "<param2>"
     And I get the first item from the list
-    Then the list item's text should be "Item One"
+    Then the list items text should be "Item One"
 
   Scenarios:
-    | search_by |
-    | name      |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/lib/page-object/accessors.rb

@@ -32,11 +32,12 @@ module PageObject
     #   # will generate 'first_name', 'first_name=' and 'first_name_text_field' methods
     #
     # @param  [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a text_field.  The valid keys are:
+    # @param [Hash] identifier how we find a text field.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
     #   * :css => Watir and Selenium
     #   * :id => Watir and Selenium
-    #   * :index => Watir only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :tag_name => Watir and Selenium
     #   * :text => Watir only
@@ -46,13 +47,13 @@ module PageObject
     #
     def text_field(name, identifier=nil, &block)
       define_method(name) do
-        platform.text_field_value_for identifier
+        platform.text_field_value_for identifier.clone
       end
       define_method("#{name}=") do |value|
-        platform.text_field_value_set(identifier, value)
+        platform.text_field_value_set(identifier.clone, value)
       end
       define_method("#{name}_text_field") do
-        block ? block.call(browser) : platform.text_field_for(identifier)
+        block ? block.call(browser) : platform.text_field_for(identifier.clone)
       end
     end
     
@@ -65,11 +66,12 @@ module PageObject
     #   # will generate 'user_id' and 'user_id_hidden_field' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a hidden field.  The valid keys are:
+    # @param [Hash] identifier how we find a hidden field.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
     #   * :css => Watir and Selenium
     #   * :id => Watir and Selenium
-    #   * :index => Watir only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :tag_name => Watir and Selenium
     #   * :text => Watir only
@@ -78,10 +80,10 @@ module PageObject
     #
     def hidden_field(name, identifier=nil, &block)
       define_method(name) do
-        platform.hidden_field_value_for identifier
+        platform.hidden_field_value_for identifier.clone
       end
       define_method("#{name}_hidden_field") do
-        block ? block.call(browser) : platform.hidden_field_for(identifier)
+        block ? block.call(browser) : platform.hidden_field_for(identifier.clone)
       end
     end
     
@@ -95,11 +97,12 @@ module PageObject
     #   # will generate 'address', 'address=' and 'address_text_area methods
     #
     # @param  [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a text area.  The valid keys are:
+    # @param [Hash] identifier how we find a text area.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
     #   * :css => Watir and Selenium
     #   * :id => Watir and Selenium
-    #   * :index => Watir only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :tag_name => Watir and Selenium
     #   * :xpath => Watir and Selenium
@@ -107,13 +110,13 @@ module PageObject
     #
     def text_area(name, identifier=nil, &block)
       define_method(name) do
-        platform.text_area_value_for identifier
+        platform.text_area_value_for identifier.clone
       end
       define_method("#{name}=") do |value|
-        platform.text_area_value_set(identifier, value)
+        platform.text_area_value_set(identifier.clone, value)
       end
       define_method("#{name}_text_area") do
-        block ? block.call(browser) : platform.text_area_for(identifier)
+        block ? block.call(browser) : platform.text_area_for(identifier.clone)
       end
     end
 
@@ -127,10 +130,11 @@ module PageObject
     #   # will generate 'state', 'state=' and 'state_select_list' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a select_list.  The valid keys are:
+    # @param [Hash] identifier how we find a select list.  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 only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :text => Watir only
     #   * :value => Watir only
@@ -139,13 +143,13 @@ module PageObject
     #
     def select_list(name, identifier=nil, &block)
       define_method(name) do
-        platform.select_list_value_for identifier
+        platform.select_list_value_for identifier.clone
       end
       define_method("#{name}=") do |value|
-        platform.select_list_value_set(identifier, value)
+        platform.select_list_value_set(identifier.clone, value)
       end
       define_method("#{name}_select_list") do
-        block ? block.call(browser) : platform.select_list_for(identifier)
+        block ? block.call(browser) : platform.select_list_for(identifier.clone)
       end
     end
 
@@ -159,11 +163,12 @@ module PageObject
     #   # will generate 'add_to_cart' and 'add_to_cart_link' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a link.  The valid keys are:
+    # @param [Hash] identifier how we find a link.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
     #   * :class => Watir and Selenium
     #   * :href => Watir only
     #   * :id => Watir and Selenium
-    #   * :index => Watir only
+    #   * :index => Watir and Selenium
     #   * :link => Watir and Selenium
     #   * :link_text => Watir and Selenium
     #   * :name => Watir and Selenium
@@ -173,10 +178,10 @@ module PageObject
     #
     def link(name, identifier=nil, &block)
       define_method(name) do
-        platform.click_link_for identifier
+        platform.click_link_for identifier.clone
       end
       define_method("#{name}_link") do
-        block ? block.call(browser) : platform.link_for(identifier)
+        block ? block.call(browser) : platform.link_for(identifier.clone)
       end
     end
     
@@ -190,26 +195,27 @@ module PageObject
     #   # will generate 'check_active', 'uncheck_active', 'active_checked?' and 'active_checkbox' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a checkbox.  The valid keys are:
+    # @param [Hash] identifier how we find a checkbox.  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 only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def checkbox(name, identifier=nil, &block)
       define_method("check_#{name}") do
-        platform.check_checkbox(identifier)
+        platform.check_checkbox(identifier.clone)
       end
       define_method("uncheck_#{name}") do
-        platform.uncheck_checkbox(identifier)
+        platform.uncheck_checkbox(identifier.clone)
       end
       define_method("#{name}_checked?") do
-        platform.checkbox_checked?(identifier)
+        platform.checkbox_checked?(identifier.clone)
       end
       define_method("#{name}_checkbox") do
-        block ? block.call(browser) : platform.checkbox_for(identifier)
+        block ? block.call(browser) : platform.checkbox_for(identifier.clone)
       end
     end
     
@@ -224,26 +230,27 @@ module PageObject
     #   # will generate 'select_north', 'clear_north', 'north_selected?' and 'north_radio_button' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a radio button.  The valid keys are:
+    # @param [Hash] identifier how we find a radio button.  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 only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def radio_button(name, identifier=nil, &block)
       define_method("select_#{name}") do
-        platform.select_radio(identifier)
+        platform.select_radio(identifier.clone)
       end
       define_method("clear_#{name}") do
-        platform.clear_radio(identifier)
+        platform.clear_radio(identifier.clone)
       end
       define_method("#{name}_selected?")  do
-        platform.radio_selected?(identifier)
+        platform.radio_selected?(identifier.clone)
       end
       define_method("#{name}_radio_button") do
-        block ? block.call(browser) : platform.radio_button_for(identifier)
+        block ? block.call(browser) : platform.radio_button_for(identifier.clone)
       end
     end
 
@@ -256,10 +263,11 @@ module PageObject
     #   # will generate 'purchase' and 'purchase_button' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a button.  The valid keys are:
+    # @param [Hash] identifier how we find a button.  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 only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :text => Watir only
     #   * :xpath => Watir and Selenium
@@ -267,10 +275,10 @@ module PageObject
     #
     def button(name, identifier=nil, &block)
       define_method(name) do
-        platform.click_button_for identifier
+        platform.click_button_for identifier.clone
       end
       define_method("#{name}_button") do
-        block ? block.call(browser) : platform.button_for(identifier)
+        block ? block.call(browser) : platform.button_for(identifier.clone)
       end
     end
     
@@ -283,20 +291,21 @@ module PageObject
     #   # will generate 'message' and 'message_div' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a div.  The valid keys are:
+    # @param [Hash] identifier how we find a div.  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 only
-    #   * :name => Selenium only
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def div(name, identifier=nil, &block)
       define_method(name) do
-        platform.div_text_for identifier
+        platform.div_text_for identifier.clone
       end
       define_method("#{name}_div") do
-        block ? block.call(browser) : platform.div_for(identifier)
+        block ? block.call(browser) : platform.div_for(identifier.clone)
       end
     end
 
@@ -309,20 +318,21 @@ module PageObject
     #   # will generate 'alert' and 'alert_span' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a span.  The valid keys are:
+    # @param [Hash] identifier how we find a span.  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 only
-    #   * :name => Selenium only
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def span(name, identifier=nil, &block)
       define_method(name) do
-        platform.span_text_for identifier
+        platform.span_text_for identifier.clone
       end
       define_method("#{name}_span") do
-        block ? block.call(browser) : platform.span_for(identifier)
+        block ? block.call(browser) : platform.span_for(identifier.clone)
       end
     end
 
@@ -334,17 +344,18 @@ module PageObject
     #   # will generate a 'cart_table' method
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a table.  The valid keys are:
+    # @param [Hash] identifier how we find a table.  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 only
-    #   * :name => Selenium only
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def table(name, identifier=nil, &block)
       define_method("#{name}_table") do
-        block ? block.call(browser) : platform.table_for(identifier)
+        block ? block.call(browser) : platform.table_for(identifier.clone)
       end
     end
     
@@ -357,20 +368,21 @@ module PageObject
     #   # will generate 'total' and 'total_cell' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a cell.  The valid keys are:
+    # @param [Hash] identifier how we find a cell.  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 only
-    #   * :name => Selenium only
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def cell(name, identifier=nil, &block)
       define_method("#{name}") do
-        platform.cell_text_for identifier
+        platform.cell_text_for identifier.clone
       end
       define_method("#{name}_cell") do
-        block ? block.call(browser) : platform.cell_for(identifier)
+        block ? block.call(browser) : platform.cell_for(identifier.clone)
       end
     end
     
@@ -382,17 +394,18 @@ module PageObject
     #   # will generate a 'logo_image' method
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find an image.  The valid keys are:
+    # @param [Hash] identifier how we find an image.  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 only
+    #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def image(name, identifier=nil, &block)
       define_method("#{name}_image") do
-        block ? block.call(browser) : platform.image_for(identifier)
+        block ? block.call(browser) : platform.image_for(identifier.clone)
       end
     end
     
@@ -404,16 +417,17 @@ module PageObject
     #   # will generate a 'login_form' method
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a form.  The valid keys are:
+    # @param [Hash] identifier how we find a form.  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 only
+    #   * :index => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def form(name, identifier=nil, &block)
       define_method("#{name}_form") do
-        block ? block.call(browser) : platform.form_for(identifier)
+        block ? block.call(browser) : platform.form_for(identifier.clone)
       end
     end
     
@@ -426,20 +440,21 @@ module PageObject
     #   # will generate 'item_one' and 'item_one_list_item' methods
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find a list item.  The valid keys are:
+    # @param [Hash] identifier how we find a list item.  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 only
-    #   * :name => Selenium only
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def list_item(name, identifier=nil, &block)
       define_method(name) do
-        platform.list_item_text_for identifier
+        platform.list_item_text_for identifier.clone
       end
       define_method("#{name}_list_item") do
-        block ? block.call(browser) : platform.list_item_for(identifier)
+        block ? block.call(browser) : platform.list_item_for(identifier.clone)
       end
     end
     
@@ -451,17 +466,18 @@ module PageObject
     #   # will generate a 'menu_unordered_list' method
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find an unordered list.  The valid keys are:
+    # @param [Hash] identifier how we find an unordered list.  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 only
-    #   * :name => Selenium only
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def unordered_list(name, identifier=nil, &block)
       define_method("#{name}_unordered_list") do
-        block ? block.call(browser) : platform.unordered_list_for(identifier)
+        block ? block.call(browser) : platform.unordered_list_for(identifier.clone)
       end
     end
     
@@ -473,17 +489,18 @@ module PageObject
     #   # will generate a 'top_five_ordered_list' method
     #
     # @param [String] the name used for the generated methods
-    # @param [Hash] identifier how we find an unordered list.  The valid keys are:
+    # @param [Hash] identifier how we find an ordered list.  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 only
-    #   * :name => Selenium only
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
     def ordered_list(name, identifier=nil, &block)
       define_method("#{name}_ordered_list") do
-        block ? block.call(browser) : platform.ordered_list_for(identifier)
+        block ? block.call(browser) : platform.ordered_list_for(identifier.clone)
       end
     end
   end