page-object 0.6.4 → 0.6.5

data/ChangeLog

@@ -1,3 +1,13 @@
+=== Version 0.6.5 / 2012-4-12
+* Enhancements
+  * Added a page level element method to return a generic Element object
+  * Added a method to retrieve all file fields on a page
+  * Updated all accessor methods to take a default identifier of {:index => 0}
+  * Updated all page level element locators to take a default identifier of {:index => 0}
+  * Updated all page level multi-element locators to take a default identifier of {}
+  * Updated deprecation warning to print to stderr (Thanks Josh Adell)
+  * Updated to use selenium-webdriver 2.21.0
+
 === Version 0.6.4 / 2012-3-27
 * Enhancements
   * Added support for finding the following elements by :css

data/features/hidden_field.feature

@@ -17,8 +17,6 @@ Feature: Hidden Fields
     | class     |
     | name      |
     | xpath     |
-    | css       |
-    | tag_name  |
     | index     |
     | text      |
     | value     |

data/features/html/multi_elements.html

@@ -136,5 +136,9 @@
     <p class="p">Paragraph Two</p>
     <p class="p">Paragraph Three</p>
     
+    <input type="file" class="file_field_class" title="File Field 1" />
+    <input type="file" class="file_field_class" title="File Field 2" />
+    <input type="file" class="file_field_class" title="File Field 3" />
+
   </body>
 </html>

data/features/multi_elements.feature

@@ -3,173 +3,288 @@ Feature: Multi Elements
   Background:
     Given I am on the multi elements page
 
-  Scenario: Selecting buttons
+  Scenario: Selecting buttons using an identifier
     When I select the buttons with class "button"
     Then I should have 3 buttons
     And the value of button 1 should be "Button 1"
     And the value of button 2 should be "Button 2"
     And the value of button 3 should be "Button 3"
+    
+  Scenario: Selecting buttons using no identifier
+    When I select all buttons using no identifier
+    Then I should have 3 buttons
 
-  Scenario: Selecting text_fields
+  Scenario: Selecting text fields using an identifier
     When I select the text fields with class "textfield"
     Then I should have 3 text fields
     And the value of text field 1 should be "text 1"
     And the value of text field 2 should be "text 2"
     And the value of text field 3 should be "text 3"
+    
+  Scenario: Selecting text fields using no identifier
+    When I select all text fields using no identifier
+    Then I should have 3 text fields
 
-  Scenario: Selecting hidden_fields
+  Scenario: Selecting hidden fields using an identifier
     When I select the hidden fields with class "hiddenfield"
     Then I should have 3 hidden fields
     And the value of hidden field 1 should be "hidden 1"
     And the value of hidden field 2 should be "hidden 2"
     And the value of hidden field 3 should be "hidden 3"
 
-  Scenario: Selecting text_areas
+  Scenario: Selecting hidden fields using no identifier
+    When I select all hidden fields using no identifier
+    Then I should have 3 hidden fields
+
+  Scenario: Selecting text areas using an identifier
     When I select the text areas with class "textarea"
     Then I should have 3 text areas
     And the value of text area 1 should be "textarea 1"
     And the value of text area 2 should be "textarea 2"
     And the value of text area 3 should be "textarea 3"
 
-  Scenario: Selecting select_lists
+  Scenario: Selecting text areas using no identifier
+    When I select text areas using no identifier
+    Then I should have 3 text areas
+
+  Scenario: Selecting select lists using an identifier
     When I select the select lists with class "selectlist"
     Then I should have 3 select lists
     And the value of select list 1 should be "selectlist 1"
     And the value of select list 2 should be "selectlist 2"
     And the value of select list 3 should be "selectlist 3"
 
-  Scenario: Selecting links
+  Scenario: Selecting select lists using no identifier
+    When I select select lists using no identifier
+    Then I should have 3 select lists
+
+  Scenario: Selecting links using an identifier
     When I select the link with class "link"
     Then I should have 3 links
     And the text of link 1 should be "link 1"
     And the text of link 2 should be "link 2"
     And the text of link 3 should be "link 3"
 
-  Scenario: Selecting checkboxes
+  Scenario: Selecting links using no identifier
+    When I select links using no identifier
+    Then I should have 3 links
+
+  Scenario: Selecting checkboxes using an identifier
     When I select the check boxes with class "checkbox"
     Then I should have 3 checkboxes
     And the value of checkbox 1 should be "checkbox 1"
     And the value of checkbox 2 should be "checkbox 2"
     And the value of checkbox 3 should be "checkbox 3"
+
+  Scenario: Selecting checkboxes using no identifier
+    When I select checboxes using no identifier
+    Then I should have 3 checkboxes
     
-  Scenario: Selecting radio buttons
+  Scenario: Selecting radio buttons using an identifier
     When I select the radio button with class "radio"
     Then I should have 3 radio buttons
     And the value of radio button 1 should be "radio 1"
     And the value of radio button 2 should be "radio 2"
     And the value of radio button 3 should be "radio 3"
 
-  Scenario: Selecting divs
+  Scenario: Selecting radio buttons using no identifier
+    When I select radio buttons using no identifier
+    Then I should have 3 radio buttons
+
+  Scenario: Selecting divs using an identifier
     When I select the div with class "div"
     Then I should have 3 divs
     And the text of div 1 should be "Div 1"
     And the text of div 2 should be "Div 2"
     And the text of div 3 should be "Div 3"
 
-  Scenario: Selecting spans
+  Scenario: Selecting divs using no identifier
+    When I select divs using no identifier
+    Then I should have 3 divs
+
+  Scenario: Selecting spans using an identifier
     When I select the spans with class "span"
     Then I should have 3 spans
     And the text of span 1 should be "Span 1"
     And the text of span 2 should be "Span 2"
     And the text of span 3 should be "Span 3"
 
-  Scenario: Selecting tables
+  Scenario: Selecting spans using no identifier
+    When I select spans using no identifier
+    Then I should have 3 spans
+
+  Scenario: Selecting tables using an identifier
     When I select the tables with class "table"
     Then I should have 3 tables
     And the first row first column for table 1 should have "Data 1"
     And the first row first column for table 2 should have "Data 4"
     And the first row first column for table 3 should have "Data 7"
 
-  Scenario: Selecting cells
+  Scenario: Selecting tables using no identifier
+    When I select tables using no identifier
+    Then I should have 3 tables
+
+  Scenario: Selecting cells using an identifier
     When I select the cells with class "td"
     Then I should have 3 cells
     And the text for cell 1 should be "Data 1"
     And the text for cell 2 should be "Data 2"
     And the text for cell 3 should be "Data 3"
 
-  Scenario: Selecting images
+  Scenario: Selecting cells using no identifier
+    When I select the cells using no identifier
+    Then I should have 9 cells
+
+  Scenario: Selecting images using an identifier
     When I select the images with class "image"
     Then I should have 3 images
     And the alt for image 1 should be "image 1"
     And the alt for image 2 should be "image 2"
     And the alt for image 3 should be "image 3"
+    
+  Scenario: Selecting images using no identifier
+    When I select the images using no identifier
+    Then I should have 3 images
 
-  Scenario: Selecting forms
+  Scenario: Selecting forms using an identifier
     When I select the forms with class "form"
     Then I should have 3 forms
     And the action for form 1 should be "form1"
     And the action for form 2 should be "form2"
     And the action for form 3 should be "form3"
+    
+  Scenario: Selecting forms using no identifier
+    When I select the forms using no identifier
+    Then I should have 3 forms
 
-  Scenario: Selecting list items
+  Scenario: Selecting list items using an identifier
     When I select the list items with class "li"
     Then I should have 3 list items
     And the text for list item 1 should be "Item One"
     And the text for list item 2 should be "Item Two"
     And the text for list item 3 should be "Item Three"
+    
+  Scenario: Selecting list items using no identifier
+    When I select the list items using no identifier
+    Then I should have 8 list items
 
-  Scenario: Selecting unordered lists
+  Scenario: Selecting unordered lists using an identifier
     When I select the unordered list with class "ul"
     Then I should have 3 unordered lists
     And the text for the first item in unordered list 1 should be "Item One"
     And the text for the first item in unordered list 2 should be "Item Four"
     And the text for the first item in unordered list 3 should be "Item Five"
     
-  Scenario: Selecting ordered lists
+  Scenario: Selecting unordered lists using no identifier
+    When I select the unordered list using no parameter
+    Then I should have 3 unordered lists
+    
+  Scenario: Selecting ordered lists using an identifier
     When I select the ordered lists with class "ol"
     Then I should have 3 ordered lists
     And the text for the first item in ordered list 1 should be "Number One"
     And the text for the first item in ordered list 2 should be "Number Two"
     And the text for the first item in ordered list 3 should be "Number Three"
+    
+  Scenario: Selecting ordered lists using no identifier
+    When I select the ordered lists using no identifier
+    Then I should have 3 ordered lists
 
-  Scenario: Selecting h1s
+  Scenario: Selecting h1s using an identifier
     When I select the h1s with class "h1"
     Then I should have 3 h1s
     And the text for h1 1 should be "H1 One"
     And the text for h1 2 should be "H1 Two"
     And the text for h1 3 should be "H1 Three"
+    
+  Scenario: Selecting h1s using no identifier
+    When I select h1s using no identifier
+    Then I should have 3 h1s
 
-  Scenario: Selecting h2s
+  Scenario: Selecting h2s using an identifier
     When I select the h2s with the class "h2"
     Then I should have 3 h2s
     And the text for h2 1 should be "H2 One"
     And the text for h2 2 should be "H2 Two"
     And the text for h2 3 should be "H2 Three"
+    
+  Scenario: Selecting h2s using no identifier
+    When I select h2s using no identifier
+    Then I should have 3 h2s
 
-  Scenario: Selecting h3s
+  Scenario: Selecting h3s using an identifier
     When I select the h3s with the class "h3"
     Then I should have 3 h3s
     And the text for h3 1 should be "H3 One"
     And the text for h3 2 should be "H3 Two"
     And the text for h3 3 should be "H3 Three"
+    
+  Scenario: Selecting h3s using no identifier
+    When I select h3s using no identifier
+    Then I should have 3 h3s
 
-  Scenario: Selecting h4s
+  Scenario: Selecting h4s using an identifier
     When I select the h4s with the class "h4"
     Then I should have 3 h4s
     And the text for H4 1 should be "H4 One"
     And the text for H4 2 should be "H4 Two"
     And the text for H4 3 should be "H4 Three"
     
-  Scenario: Selecting h5s
+  Scenario: Selecting h4s using no identifier
+    When I select h4s using no identifier
+    Then I should have 3 h4s
+    
+  Scenario: Selecting h5s using an identifier
     When I select the h5s with the class "h5"
     Then I should have 3 h5s
     And the text for H5 1 should be "H5 One"
     And the text for H5 2 should be "H5 Two"
     And the text for H5 3 should be "H5 Three"
+    
+  Scenario: Selecting h5s using no identifier
+    When I select h5s using no identifier
+    Then I should have 3 h5s
 
-  Scenario: Selecting h6s
+  Scenario: Selecting h6s using an identifier
     When I select the h6s with the class "h6"
     Then I should have 3 h6s
     And the text for H6 1 should be "H6 One"
     And the text for H6 2 should be "H6 Two"
     And the text for H6 3 should be "H6 Three"
+    
+  Scenario: Selecting h6s using no identifier
+    When I select h6s using no identifier
+    Then I should have 3 h6s
 
-  Scenario: Selecting paragraphs
+  Scenario: Selecting paragraphs using an identifier
     When I select the paragraph with class "p"
     Then I should have 3 paragraphs
     And the text for paragraph 1 should be "Paragraph One"
     And the text for paragraph 2 should be "Paragraph Two"
     And the text for paragraph 3 should be "Paragraph Three"
 
+  Scenario: Selecting paragraphs using no identifier
+    When I select paragraphs using no identifier
+    Then I should have 3 paragraphs
+
+  Scenario: Selecting labels with an identifier
+    When I select the labels with class "label"
+    Then I should have 3 labels
+    And the text for label 1 should be "Label 1"
+    And the text for label 2 should be "Label 2"
+    And the text for label 3 should be "Label 3"
+
+  Scenario: Selecting labels using no identifier
+    When I select labels using no identifier
+    Then I should have 3 labels
 
+  Scenario: Selecting file fields with an identifier
+    When I select the file fields with class "file_field_class"
+    Then I should have 3 file fields
+    And the title for file field 1 should be "File Field 1"
+    And the title for file field 2 should be "File Field 2"
+    And the title for file field 3 should be "File Field 3"
 
+  Scenario: Selecting file fields using no identifier
+    When I select the file fields using no identifier
+    Then I should have 3 file fields

data/features/step_definitions/multi_elements_steps.rb

@@ -295,3 +295,111 @@ end
 Then /^the text for paragraph (\d+) should be "([^\"]*)"$/ do |para_num, text|
   @elements[para_num.to_i - 1].text.should == text
 end
+
+When /^I select all buttons using no identifier$/ do
+  @elements = @page.button_elements
+end
+
+When /^I select all text fields using no identifier$/ do
+  @elements = @page.text_field_elements
+end
+
+When /^I select all hidden fields using no identifier$/ do
+  @elements = @page.hidden_field_elements
+end
+
+When /^I select text areas using no identifier$/ do
+  @elements = @page.text_area_elements
+end
+
+When /^I select select lists using no identifier$/ do
+  @elements = @page.select_list_elements
+end
+
+When /^I select links using no identifier$/ do
+  @elements = @page.link_elements
+end
+
+When /^I select checboxes using no identifier$/ do
+  @elements = @page.checkbox_elements
+end
+
+When /^I select radio buttons using no identifier$/ do
+  @elements = @page.radio_button_elements
+end
+
+When /^I select divs using no identifier$/ do
+  @elements = @page.div_elements
+end
+
+When /^I select spans using no identifier$/ do
+  @elements = @page.span_elements
+end
+
+When /^I select tables using no identifier$/ do
+  @elements = @page.table_elements
+end
+
+When /^I select the cells using no identifier$/ do
+  @elements = @page.cell_elements
+end
+
+When /^I select the images using no identifier$/ do
+  @elements = @page.image_elements
+end
+
+When /^I select the forms using no identifier$/ do
+  @elements = @page.form_elements
+end
+
+When /^I select the list items using no identifier$/ do
+  @elements = @page.list_item_elements
+end
+
+When /^I select the unordered list using no parameter$/ do
+  @elements = @page.unordered_list_elements
+end
+
+When /^I select the ordered lists using no identifier$/ do
+  @elements = @page.ordered_list_elements
+end
+
+When /^I select h(\d+)s using no identifier$/ do |num|
+  @elements = @page.send "h#{num}_elements"
+end
+
+When /^I select paragraphs using no identifier$/ do
+  @elements = @page.paragraph_elements
+end
+
+When /^I select the labels with class "([^\"]*)"$/ do |class_name|
+  @elements = @page.label_elements(:class => class_name)
+end
+
+Then /^I should have (\d+) labels$/ do |num_labels|
+  @elements.size.should == num_labels.to_i
+end
+
+Then /^the text for label (\d+) should be "([^\"]*)"$/ do |label_num, text|
+  @elements[label_num.to_i - 1].text.should == text
+end
+
+When /^I select labels using no identifier$/ do
+  @elements = @page.label_elements
+end
+
+When /^I select the file fields with class "([^\"]*)"$/ do |class_name|
+  @elements = @page.file_field_elements(:class => class_name)
+end
+
+Then /^I should have (\d+) file fields$/ do |num_file_fields|
+  @elements.size.should == num_file_fields.to_i
+end
+
+Then /^the title for file field (\d+) should be "([^\"]*)"$/ do |file_field_num, title|
+  @elements[file_field_num.to_i - 1].attribute('title').should == title
+end
+
+When /^I select the file fields using no identifier$/ do
+  @elements = @page.file_field_elements
+end