page-object 0.7.6 → 0.8

data/ChangeLog

@@ -1,3 +1,40 @@
+=== Version 0.8 / 2012-12-22
+* Enhancements
+  * Added the following class level methods to return all elements matching the locator
+    * divs
+    * buttons
+    * text_fields
+    * hidden_fields
+    * text_areas
+    * select_lists
+    * links
+    * checkboxes
+    * radio_buttons
+    * spans
+    * tables
+    * cells
+    * images
+    * forms
+    * list_items
+    * unordered_lists
+    * ordered_lists
+    * h1s
+    * h2s
+    * h3s
+    * h4s
+    * h5s
+    * h6s
+    * paragraphs
+    * labels
+    * file_fields
+  * Added ability to register and use custom elements based on standard elements (William Powell)
+  * Added generated method to return text for a table
+  * Added generated method to return text for an unordered list
+  * Added generated method to return text for an ordered list
+  * Added html method to Element
+  * Updated to use the latest selenium-webdriver 2.27.2
+  * Updated to use the latest watir-webdriver 0.6.2
+
 === Version 0.7.6 / 2012-11-28
 * Fixes
   * Fixed attach_to_window workes with partial url on Selenium (George Shakhnazaryan)

data/features/element.feature

@@ -26,6 +26,7 @@ Feature: Elements
     Then I should know it exists
     And I should know it is visible
     And I should know the text is "Google Search"
+    And I should know the html is "<a href="success.html" id="link_id" name="link_name" class="link_class" title="link_title">Google Search</a>"
     And I should know it is equal to itself
     And I should know the tag name is "a"
     And I should know the attribute "readonly" is false
@@ -289,4 +290,4 @@ Feature: Elements
   Scenario: Double Clicking
     Given I am on the Double Click page
     When I double click the button
-    Then the paragraph should read "Double Click Received"
+    Then the paragraph should read "Double Click Received"

data/features/gxt_table_extension.feature

@@ -0,0 +1,24 @@
+Feature: Gxt Table Extension
+  As a Quality Engineer working on a Gxt or Gwt project
+  In order to easily create test widgets to interact with application widgets
+  I need to define, register and use widgets as if they were normal elements
+
+  Background:
+    Given I have defined a GxtTable class extending Table
+    And I have registered the GxtTable with PageObject
+    And I define a page-object using that widget
+    And I am on the Gxt Examples page
+    And I have the Basic Grid opened
+
+  Scenario: Retrieve a GxtTable
+    When I retrieve a GxtTable widget
+    Then I should know it is visible
+
+  @watir_only
+  Scenario: Determine if a GxtTable exists
+    When I retrieve a GxtTable widget
+    Then I should know it exists
+
+  Scenario: Confirm a correct row count from a GxtTable
+    When I retrieve a GxtTable widget
+    And the GxtTable should have "13" rows

data/features/multi_elements.feature

@@ -288,3 +288,185 @@ Feature: Multi Elements
   Scenario: Selecting file fields using no identifier
     When I select the file fields using no identifier
     Then I should have 3 file fields
+
+  Scenario: Selecting all divs based on a class declaration
+    When I select the divs using the generated method
+    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 buttons based on a class declaration
+    When I select the buttons using the generated method
+    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 text fields based on a class declaration
+    When I select the text fields using the generated method
+    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 hidden fields based on a class declaration
+    When I select the hidden fields using the generated method
+    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 based on a class declaration
+    When I select the text areas using the generated method
+    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 based on a class declaration
+    When I select the select lists using the generated method
+    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 based on a class declaration
+    When I select the link using the generated method
+    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 based on a class declaration
+    When I select the check boxes using the generated method
+    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 radio buttons based on a class declaration
+    When I select the radio button using the generated method
+    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 spans based on a class declaration
+    When I select the spans using the generated method
+    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 based on a class declaration
+    When I select the tables using the generated method
+    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 based on a class declaration
+    When I select the cells using the generated method
+    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 based on a class declaration
+    When I select the images using the generated method
+    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 forms based on a class declaration
+    When I select the forms using the generated method
+    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 list items based on a class declaration
+    When I select the list items using the generated method
+    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 unordered lists based on a class declaration
+    When I select the unordered list using the generated method
+    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 based on a class declaration
+    When I select the ordered lists using the generated method
+    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 h1s based on a class declaration
+    When I select the h1s using the generated method
+    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 h2s based on a class declaration
+    When I select the h2s using the generated method
+    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 h3s based on a class declaration
+    When I select the h3s using the generated method
+    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 h4s based on a class declaration
+    When I select the h4s using the generated method
+    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 based on a class declaration
+    When I select the h5s using the generated method
+    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 h6s based on a class declaration
+    When I select the h6s using the generated method
+    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 paragraphs based on a class declaration
+    When I select the paragraph using the generated method
+    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 labels based on a class declaration
+    When I select the labels using the generated method
+    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 file fields based on a class declaration
+    When I select the file fields using the generated method
+    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"

data/features/ordered_list.feature

@@ -49,3 +49,8 @@ Feature: Ordered 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"
+
+  Scenario: Getting the test for an ordered list
+    Then the text for the ordered list should contain "Number One"
+    And the text for the ordered list should contain "Number Two"
+    And the text for the ordered list should contain "Number Three"

data/features/step_definitions/element_steps.rb

@@ -78,6 +78,10 @@ Then /^I should know the text is "(.*)"$/ do |text|
   @element.text.should == text
 end
 
+Then /^I should know the html is "(.*)"$/ do |html|
+  @element.html.should == html
+end
+
 Then /^I should know the text includes "(.*)"$/ do |text|
   @element.text.should include text
 end
@@ -228,6 +232,7 @@ When /^I double click the button$/ do
   @page.click_element.double_click
 end
 
-Then /^the paragraph should read "([^"]*)"$/ do |expected_text|
+Then /^the paragraph should read "([^\"]*)"$/ do |expected_text|
   @page.text.should == expected_text
-end
+end
+

data/features/step_definitions/gxt_table_steps.rb

@@ -0,0 +1,40 @@
+Given /^I am on the Gxt Examples page$/ do
+  @page = GxtSamplePageObject.new(@browser)
+  @page.navigate_to "http://gxtexamplegallery.appspot.com/"
+end
+
+When /^I have the Basic Grid opened$/ do
+  @page.basic_grid_element.click
+end
+
+When /^I have defined a GxtTable class extending Table$/ do
+  class GxtTable < PageObject::Elements::Table
+
+    protected
+    def child_xpath
+      ".//descendant::tr"
+    end
+  end
+end
+
+When /^I have registered the GxtTable with PageObject$/ do
+  PageObject.register_widget :gxt_table, GxtTable, 'div'
+end
+
+When /^I retrieve a GxtTable widget$/ do
+  @element = @page.gxt_table_element
+end
+
+
+When /^the GxtTable should have "(\d+)" rows$/ do |rows|
+  @element.rows.should == rows.to_i
+end
+
+When /^I define a page-object using that widget$/ do
+  class GxtSamplePageObject
+    include PageObject
+
+    div(:basic_grid, :class => "label_basic_grid")
+    gxt_table(:gxt_table, :class => "x-grid3")
+  end
+end

data/features/step_definitions/multi_elements_steps.rb

@@ -1,5 +1,32 @@
 class MultiElementsPage
   include PageObject
+
+  divs(:the_divs, :class => 'div')
+  buttons(:the_buttons, :class => 'button')
+  text_fields(:the_text_fields, :class => 'textfield')
+  hidden_fields(:the_hidden_fields, :class => 'hiddenfield')
+  text_areas(:the_text_areas, :class => 'textarea')
+  select_lists(:the_select_lists, :class => 'selectlist')
+  links(:the_links, :class => 'link')
+  checkboxes(:the_checkboxes, :class => 'checkbox')
+  radio_buttons(:the_radio_buttons, :class => 'radio')
+  spans(:the_spans, :class => 'span')
+  tables(:the_tables, :class => 'table')
+  cells(:the_cells, :class => 'td')
+  images(:the_images, :class => 'image')
+  forms(:the_forms, :class => 'form')
+  list_items(:the_list_items, :class => 'li')
+  unordered_lists(:the_unordered_lists, :class => 'ul')
+  ordered_lists(:the_ordered_lists, :class => 'ol')
+  h1s(:the_h1s, :class => 'h1')
+  h2s(:the_h2s, :class => 'h2')
+  h3s(:the_h3s, :class => 'h3')
+  h4s(:the_h4s, :class => 'h4')
+  h5s(:the_h5s, :class => 'h5')
+  h6s(:the_h6s, :class => 'h6')
+  paragraphs(:the_paragraphs, :class => 'p')
+  labels(:the_labels, :class => 'label')
+  file_fields(:the_file_fields, :class => 'file_field_class')
 end
 
 
@@ -403,3 +430,87 @@ end
 When /^I select the file fields using no identifier$/ do
   @elements = @page.file_field_elements
 end
+
+When /^I select the divs using the generated method$/ do
+  @elements = @page.the_divs_elements
+end
+
+When /^I select the buttons using the generated method$/ do
+  @elements = @page.the_buttons_elements
+end
+
+When /^I select the text fields using the generated method$/ do
+  @elements = @page.the_text_fields_elements
+end
+
+When /^I select the hidden fields using the generated method$/ do
+  @elements = @page.the_hidden_fields_elements
+end
+
+When /^I select the text areas using the generated method$/ do
+  @elements = @page.the_text_areas_elements
+end
+
+When /^I select the select lists using the generated method$/ do
+  @elements = @page.the_select_lists_elements
+end
+
+When /^I select the link using the generated method$/ do
+  @elements = @page.the_links_elements
+end
+
+When /^I select the check boxes using the generated method$/ do
+  @elements = @page.the_checkboxes_elements
+end
+
+When /^I select the radio button using the generated method$/ do
+  @elements = @page.the_radio_buttons_elements
+end
+
+When /^I select the spans using the generated method$/ do
+  @elements = @page.the_spans_elements
+end
+
+When /^I select the tables using the generated method$/ do
+  @elements = @page.the_tables_elements
+end
+
+When /^I select the cells using the generated method$/ do
+  @elements = @page.the_cells_elements
+end
+
+When /^I select the images using the generated method$/ do
+  @elements = @page.the_images_elements
+end
+
+When /^I select the forms using the generated method$/ do
+  @elements = @page.the_forms_elements
+end
+
+When /^I select the list items using the generated method$/ do
+  @elements = @page.the_list_items_elements
+end
+
+When /^I select the unordered list using the generated method$/ do
+  @elements = @page.the_unordered_lists_elements
+end
+
+When /^I select the ordered lists using the generated method$/ do
+  @elements = @page.the_ordered_lists_elements
+end
+
+When /^I select the h(\d+)s using the generated method$/ do |num|
+  @elements = @page.send "the_h#{num.to_i}s_elements"
+end
+
+When /^I select the paragraph using the generated method$/ do
+  @elements = @page.the_paragraphs_elements
+end
+
+When /^I select the labels using the generated method$/ do
+  @elements = @page.the_labels_elements
+end
+
+When /^I select the file fields using the generated method$/ do
+  @elements = @page.the_file_fields_elements
+end