page-object 1.0.3 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 10f43de4180ab498bb6929df07232deeee0ab0fb
-  data.tar.gz: fd5f9cb5d67e7af41c90a645e32e33a6babf2a2a
+  metadata.gz: 5e87a5991df66aba958bfa1d69bd5defb8f5dbfc
+  data.tar.gz: 2fccd9a610ae80b2c9762a0f9bdc2827b55ac5e7
 SHA512:
-  metadata.gz: 76cbc1ff4202177c001c56f574395cb7c233eca802acb1c7e448c709536c5af68cea6cb77be1bdbbf327ead2cc67f920de58da9513e218cf773b5ade4fd14fe5
-  data.tar.gz: eeca209c3157f4d49d6458952546f5130127c342f38d1515fb3c95e4bfaf81479c3147e8fb9ad0255d13ed98bb3e083bed1dc3b38890cf02a262305f49f98e44
+  metadata.gz: f7c67f99e80f010e75da294dcd4894454d0d4a30ffdb9b9396e48c2c440abaa41a853491f1f7de0c184e9486ddeb7580d7efca54477c8e221acc8395f2648e11
+  data.tar.gz: ae0f71731920795dd10e2eb77c7702bc6fc64bca0c4c9ef52a9a3da459399a2ec67d95c79fc371f625b313b29d9b72296e9d8e86335822faf452901ca324b210

data/ChangeLog

@@ -1,3 +1,13 @@
+=== Version 1.1.0
+* Enhancements
+  * Performance enhancements when initializing elements (Thanks Dane Andersen)
+  * Enabled button elements to return text when using selenium-webdriver.
+  * Added support for :index identifier in indexed properties.
+  * Added page_section and page_sections accessor methods which can specify a page object of elements on another page object.
+* Fixes
+  * Fixed issue causing exceptions when comparing equality of element to non-element objects.
+  * Fixed issue that causes indexed properties to return the same value for any index.
+
 === Version 1.0.3 / 2014-12-9
 * Enhancements
   * Added support for the bold tag (Thanks sedx)

data/features/button.feature

@@ -9,11 +9,11 @@ Feature: Button
   Scenario: Clicking a button (type=submit)
     When I click the button
     Then I should be on the success page
-    
+
   Scenario: Clicking a button (type=image)
     When I click the button with type image
     Then I should be on the success page
-    
+
   Scenario: Clicking an image button by src
     When I click the image button using src
     Then I should be on the success page
@@ -62,6 +62,16 @@ Feature: Button
     | search_by |
     | text      |
 
+    @dane
+  Scenario Outline: Getting the text from a button
+    When I get the text for a button that is a "<tag>"
+    Then the text should be "This button is a <tag>"
+
+  Scenarios:
+    | tag    |
+    | button |
+    | input  |
+
   Scenario Outline: Locating button using multiple parameters
     When I search for the button by "<param1>" and "<param2>"
     Then I should be able to click the button
@@ -70,7 +80,7 @@ Feature: Button
     | param1 | param2 |
     | class  | index  |
     | name   | index  |
-    
+
   Scenario Outline: Locating real button using multiple parameters
     When I search for the button by "<param1>" and "<param2>"
     Then I should be able to click the real button

data/features/html/indexed_property.html

@@ -12,6 +12,7 @@
                 <td><textarea id="table[123].area" rows="2" cols="20"></textarea></td>
                 <td><input id="table[123].button" type="submit" value="Click 123"/></td>
                 <td><div id="table[123].content">123!</div></td>
+                <td><div id="table[123].bad_name">BAD ELEMENT NAME</div></td>
             </tr>
             <tr>
                 <td><input type="text" id="table[foo].text" name="tableName[foo].text" size="20"/></td>
@@ -20,6 +21,7 @@
                 <td><textarea id="table[foo].area" rows="2" cols="20"></textarea></td>
                 <td><input id="table[foo].button" type="submit" value="Click foo"/></td>
                 <td><div id="table[foo].content">foo!</div></td>
+                <td><div id="table[foo].bad_name">BAD ELEMENT NAME</div></td>
             </tr>
             <tr>
                 <td><input type="text" id="table[12test].text" name="tableName[12test].text" size="20"/></td>
@@ -28,6 +30,7 @@
                 <td><textarea id="table[12test].area" rows="2" cols="20"></textarea></td>
                 <td><input id="table[12test].button" type="submit" value="Click 12test"/></td>
                 <td><div id="table[12test].content">12test!</div></td>
+                <td><div id=""table[12test].bad_name>BAD ELEMENT NAME</div></td>
             </tr>
         </table>
 

data/features/html/static_elements.html

@@ -199,6 +199,8 @@
     <img src="images/img_pulpit.jpg" alt="The Pulpit Rock" width="304" height="228">
   </figure>
   This text have <b id="b_id" class="b_class" name="b_name">some text in bold</b>
+  <button id="button_button">This button is a button</button>
+  <input id="input_button" type="button" value="This button is a input" />
   </body>
 </html>
 

data/features/indexed_property.feature

@@ -71,6 +71,16 @@ Feature: Indexed Property
     | 123    |
     | 12test |
 
+  Scenario Outline: Locating indexed text fields by index in a table on the page
+    When I search for the elements for index "<index>"
+    And I select the table's indexed radio button
+    Then The table's indexed radio button should be selected
+
+  Scenarios:
+    | index |
+    | 0     |
+    | 1     |
+
   Scenario Outline: Locating indexed text fields outside a table on the Page
     When I search for the elements for index "<index>"
     And I type "I found it" into the regular indexed text field by id
@@ -95,4 +105,13 @@ Feature: Indexed Property
   Scenario: Index on first indexed property and different on second
     When I search for an element with text by an index on an indexed property
     And I search using an index which is on another indexed property
-    Then I should see the content of the element on the second indexed property
+    Then I should see the content of the element on the second indexed property
+
+  Scenario: Different indexes on stored indexed property
+    When I search for an element with text by an index on an indexed property
+    And I search for a different element with text by index on the indexed property
+    Then I should see the contents of both elements
+
+  Scenario: Can't redefine ruby methods
+    When I use a name that collides with a ruby method on an indexed property
+    Then the original method remains

data/features/section.feature

@@ -0,0 +1,132 @@
+Feature: Sections
+
+  Background:
+    Given I am on the section elements page
+
+  Scenario: Getting the text from a section
+    When I get the text from the section
+    Then the text should include "page-object rocks!"
+
+  Scenario: Cannot find elements not in the section
+    When I access an element that is outside of the section
+    Then I should see that it doesn't exist in the section
+
+  Scenario: Finding a link within a section
+    When I search for a link located in a section
+    Then I should be able to click the section link
+
+  Scenario: Finding a button within a section
+    When I search for a button located in a section
+    Then I should be able to click the section button
+
+  Scenario: Finding a text field within a section
+    When I search for a text field located in a section
+    Then I should be able to type "123abc" in the section text field
+
+  Scenario: Finding a hidden field within a section
+    When I search for a hidden field located in a section
+    Then I should be able to see that the section hidden field contains "LeanDog"
+
+  Scenario: Finding a text area within a section
+    When I search for a text area located in a section
+    Then I should be able to type "abcdefg" in the section text area
+
+  Scenario: Finding a select list within a section
+    When I search for a select list located in a section
+    Then I should be able to select "Test 2" in the section select list
+
+  Scenario: Finding a file field within a section
+    When I search for a file field located in a section
+    Then I should be able to set the section file field
+
+  Scenario: Finding a checkbox within a section
+    When I search for a checkbox located in a section
+    Then I should be able to check the section checkbox
+
+  Scenario: Finding a radio button witin a section
+    When I search for a radio button located in a section
+    Then I should be able to select the section radio button
+
+  Scenario: Finding a div within a section
+    When I search for a div located in a section
+    Then I should see the text "page-object rocks!" in the section div
+
+  Scenario: Finding a span within a section
+    When I search for a span located in a section
+    Then I should see the text "My alert" in the section span
+
+  Scenario: Finding a table within a section
+    When I search for a table located in a section
+    Then the data for row "1" of the section table should be "Data1" and "Data2"
+
+  Scenario: Finding a table cell within a section
+    When I search the second table cell located in a table in a section
+    Then the section table cell should contain "Data2"
+
+  Scenario: Finding an image within a section
+    When I search for an image located in a section
+    Then the section image should be "106" pixels wide
+    And the section image should be "106" pixels tall
+
+  Scenario: Finding a form within a section
+    When I search for a form located in a section
+    Then I should be able to submit the section form
+
+  Scenario: Finding an ordered list within a section
+    When I search for an ordered list located in a section
+    Then the first section list items text should be "Number One"
+
+  Scenario: Finding an unordered list within a section
+    When I search for an unordered list located in a section
+    Then the first section list items text should be "Item One"
+
+  Scenario: Finding a list item section in an ordered list within a section
+    When I search for a list item section in an ordered list in a section
+    Then I should see the section list items text should be "Number One"
+
+  Scenario: Finding a h1 within a section
+    When I search for a h1 located in a section
+    Then I should see the section h1s text should be "h1's are cool"
+
+  Scenario: Finding a h2 within a section
+    When I search for a h2 located in a section
+    Then I should see the section h2s text should be "h2's are cool"
+
+  Scenario: Finding a h3 within a section
+    When I search for a h3 located in a section
+    Then I should see the section h3s text should be "h3's are cool"
+
+  Scenario: Finding a h4 within a section
+    When I search for a h4 located in a section
+    Then I should see the section h4s text should be "h4's are cool"
+
+  Scenario: Finding a h5 within a section
+    When I search for a h5 located in a section
+    Then I should see the section h5s text should be "h5's are cool"
+
+  Scenario: Finding a h6 within a section
+    When I search for a h6 located in a section
+    Then I should see the section h6s text should be "h6's are cool"
+
+  Scenario: Finding a paragraph within a section
+    When I search for a paragraph located in a section
+    Then I should see the section paragraphs text should be "This is a paragraph."
+
+  Scenario: Indexed property in section
+    Given I search for a link in an indexed property located in a section
+    Then I should see the text "Success" in the section indexed link
+
+  Scenario: Selecting multiple sections
+    When I select multiple sections
+    Then I should have a section collection containing the sections
+    And I can access any index of that collection of sections
+
+  Scenario: Searching section collection
+    Given I select multiple sections
+    When I search by a specific value of the section
+    Then I will find the first section with that value
+
+  Scenario: Filtering section collection
+    Given I select multiple sections
+    When I filter by a specific value of the sections
+    Then I will find all sections with that value

data/features/step_definitions/accessor_steps.rb

@@ -6,6 +6,10 @@ Then /^the text should be "([^\"]*)"$/ do |expected_text|
   @text.should == expected_text
 end
 
+Then /^the text should include "([^\"]*)"$/ do |expected_text|
+  expect(@text).to include expected_text
+end
+
 Then /^I should be on the success page$/ do
   @page.text.should include 'Success'
   @page.title.should == 'Success'

data/features/step_definitions/button_steps.rb

@@ -41,3 +41,8 @@ end
 Then /^I should see that the button exists$/ do
   @page.button_id?.should == true
 end
+
+
+When(/^I get the text for a button that is a "([^"]*)"$/) do |tagname|
+  @text = @page.button_element(:id => "#{tagname}_button").text
+end

data/features/step_definitions/indexed_property_steps.rb

@@ -7,7 +7,11 @@ class IndexedPropertyPage
                             [:checkbox, :check, {:id => 'table[%s].check'}],
                             [:text_area, :area, {:id => 'table[%s].area'}],
                             [:button, :button, {:id => 'table[%s].button'}],
-                            [:div, :content, {:id => 'table[%s].content'}]]
+                            [:div, :content, {:id => 'table[%s].content'}],
+                            [:div, :nil?, {:id => 'table[%s].bad_name'}],
+                         ]
+
+  indexed_property :index_table, [[:radio_button, :radio, {:index => '%d'}]]
 
   indexed_property :nottable, [[:text_field, :text_nottable, {:id => 'nottable[%s].text'}]]
 
@@ -125,5 +129,35 @@ Then(/^I should see the content of the element on the second indexed property$/)
 end
 
 When(/^I search for an element with text by an index on an indexed property$/) do
-  expect(page.table['123'].content).to eq '123!'
+  @indexed_property = page.table
+  @contents = [@indexed_property['123'].content]
+  expect(@contents[0]).to eq '123!'
+end
+
+And(/^I search for a different element with text by index on the indexed property$/) do
+  @contents << @indexed_property['12test'].content
+end
+
+Then(/^I should see the contents of both elements$/) do
+  expect(@contents).to eq ['123!','12test!']
+end
+
+When(/^I use a name that collides with a ruby method on an indexed property$/) do
+  #noop element is already defined on indexed property
+end
+
+Then(/^the original method remains$/) do
+  expect(page.table['foo'].nil?).to be false
+end
+
+When(/^I search for the elements with index (.*)$/) do |index|
+  @index = index.to_i
+end
+
+And(/^I select the table's indexed radio button$/) do
+  page.index_table[@index].select_radio
+end
+
+Then(/^The table's indexed radio button should be selected$/) do
+  expect(page.index_table[@index]).to be_radio_selected
 end

data/features/step_definitions/section_steps.rb

@@ -0,0 +1,268 @@
+class Container
+  include PageObject
+
+  link(:section_link)
+  button(:section_button)
+  text_field(:section_text_field)
+  hidden_field(:section_hidden_field)
+  text_area(:section_text_area)
+  select_list(:section_select_list)
+  checkbox(:section_checkbox)
+  radio_button(:section_radio_button)
+  div(:section_div)
+  span(:section_span)
+  table(:section_table)
+  cell(:section_cell) { |page| page.section_table_element.cell_element(:index => 1) }
+  image(:section_image)
+  form(:section_form)
+  ordered_list(:section_ordered_list)
+  unordered_list(:section_unordered_list)
+  list_item(:section_list_item) { |page| page.section_ordered_list_element.list_item_element }
+  h1(:section_h1)
+  h2(:section_h2)
+  h3(:section_h3)
+  h4(:section_h4)
+  h5(:section_h5)
+  h6(:section_h6)
+  paragraph(:section_paragraph)
+  file_field(:section_file_field)
+
+  indexed_property(:indexed_list,[[:link,:indexed_link,href: '%s.html']])
+
+  unordered_list(:outside_section, :id => 'outer')
+end
+
+class InputSection
+  include PageObject
+
+  def value
+    root.value
+  end
+end
+
+class SectionElementsPage
+  include PageObject
+
+  page_section(:container, Container, :id => 'div_id')
+  page_sections(:page_inputs, InputSection, :tag_name => 'input')
+end
+
+When(/^I get the text from the section$/) do
+  @text = @page.container.text
+end
+
+Given /^I am on the section elements page$/ do
+  @page = SectionElementsPage.new(@browser)
+  @page.navigate_to(UrlHelper.nested_elements)
+end
+
+When /^I search for a link located in a section$/ do
+  @link = @page.container.section_link_element
+end
+
+Then /^I should be able to click the section link$/ do
+  @link.click
+end
+
+When /^I search for a button located in a section$/ do
+  @button = @page.container.section_button_element
+end
+
+Then /^I should be able to click the section button$/ do
+  @button.click
+end
+
+When /^I search for a text field located in a section$/ do
+  @text_field = @page.container.section_text_field_element
+end
+
+Then /^I should be able to type "([^\"]*)" in the section text field$/ do |value|
+  @text_field.value = value
+end
+
+When /^I search for a hidden field located in a section$/ do
+  @hidden_field = @page.container.section_hidden_field_element
+end
+
+Then /^I should be able to see that the section hidden field contains "([^\"]*)"$/ do |value|
+  @hidden_field.value.should == value
+end
+
+When /^I search for a text area located in a section$/ do
+  @text_area = @page.container.section_text_area_element
+end
+
+Then /^I should be able to type "([^\"]*)" in the section text area$/ do |value|
+  @text_area.value = value
+end
+
+When /^I search for a select list located in a section$/ do
+  @select_list = @page.container.section_select_list_element
+end
+
+Then /^I should be able to select "([^\"]*)" in the section select list$/ do |value|
+  @select_list.select value
+end
+
+When /^I search for a checkbox located in a section$/ do
+  @checkbox = @page.container.section_checkbox_element
+end
+
+Then /^I should be able to check the section checkbox$/ do
+  @checkbox.check
+end
+
+When /^I search for a radio button located in a section$/ do
+  @radio = @page.container.section_radio_button_element
+end
+
+Then /^I should be able to select the section radio button$/ do
+  @radio.select
+end
+
+When /^I search for a div located in a section$/ do
+  @div = @page.container.section_div_element
+end
+
+Then /^I should see the text "([^\"]*)" in the section div$/ do |value|
+  @div.text.should == value
+end
+
+Then /^I should see the text "([^\"]*)" in the section indexed link$/ do |value|
+  @link.text.should == value
+end
+
+When /^I search for a span located in a section$/ do
+  @span = @page.container.section_span_element
+end
+
+Then /^I should see the text "([^\"]*)" in the section span$/ do |value|
+  @span.text.should == value
+end
+
+When /^I search for a table located in a section$/ do
+  @table = @page.container.section_table_element
+end
+
+Then /^the data for row "([^\"]*)" of the section table should be "([^\"]*)" and "([^\"]*)"$/ do |row, col1, col2|
+  table_row = @table[row.to_i - 1]
+  table_row[0].text.should == col1
+  table_row[1].text.should == col2
+end
+
+When /^I search the second table cell located in a table in a section$/ do
+  @cell = @page.container.section_cell_element
+end
+
+Then /^the section table cell should contain "([^\"]*)"$/ do |value|
+  @cell.text.should == value
+end
+
+When /^I search for an image located in a section$/ do
+  @image = @page.container.section_image_element
+end
+
+Then /^the section image should be "([^\"]*)" pixels wide$/ do |width|
+  @image.width.should == width.to_i
+end
+
+Then /^the section image should be "([^\"]*)" pixels tall$/ do |height|
+  @image.height.should == height.to_i
+end
+
+When /^I search for a form located in a section$/ do
+  @form = @page.container.section_form_element
+end
+
+Then /^I should be able to submit the section form$/ do
+  @form.submit
+end
+
+When /^I search for an ordered list located in a section$/ do
+  @list = @page.container.section_ordered_list_element
+end
+
+Then /^the first section list items text should be "([^\"]*)"$/ do |value|
+  @list[0].text.should == value
+end
+
+When /^I search for an unordered list located in a section$/ do
+  @list = @page.container.section_unordered_list_element
+end
+
+When /^I search for a list item section in an ordered list in a section$/ do
+  @li = @page.container.section_list_item_element
+end
+
+Then /^I should see the section list items text should be "([^\"]*)"$/ do |value|
+  @li.text.should == value
+end
+
+When /^I search for a h(\d+) located in a section$/ do |num|
+  @header = @page.container.send "section_h#{num}_element"
+end
+
+Then /^I should see the section h(\d+)s text should be "([^\"]*)"$/ do |num, value|
+  @header.text.should == value
+end
+
+When /^I search for a paragraph located in a section$/ do
+  @para = @page.container.section_paragraph_element
+end
+
+Then /^I should see the section paragraphs text should be "([^\"]*)"$/ do |value|
+  @para.text.should == value
+end
+
+When /^I search for a file field located in a section$/ do
+  @ff = @page.container.section_file_field_element
+end
+
+Then /^I should be able to set the section file field$/ do
+  @ff.value = __FILE__
+end
+
+When(/^I access an element that is outside of the section$/) do
+  @element = @page.container.outside_section_element
+end
+
+Then(/^I should see that it doesn't exist in the section$/) do
+  expect(@element).not_to exist
+end
+
+When(/^I select multiple sections$/) do
+  @sections = @page.page_inputs
+end
+
+Then(/^I should have a section collection containing the sections$/) do
+  expect(@sections).to be_an_instance_of(PageObject::SectionCollection)
+end
+
+When(/^I search by a specific value of the section$/) do
+  @element = @sections.find_by(:value => 'LeanDog')
+end
+
+Then(/^I will find the first section with that value$/) do
+  expect(@element).to be_a(PageObject)
+  expect(@element.value).to eq 'LeanDog'
+end
+
+When(/^I filter by a specific value of the sections$/) do
+  @elements = @sections.select_by(:value => /\w+/)
+end
+
+Then(/^I will find all sections with that value$/) do
+  expect(@elements).to be_a PageObject::SectionCollection
+  @elements.map(&:value).each do |element|
+    expect(element).to match(/\w+/)
+  end
+end
+
+And(/^I can access any index of that collection of sections$/) do
+  expect(@sections[0]).to be_a(PageObject)
+  expect(@sections[-1]).to be_a(PageObject)
+end
+
+Given(/^I search for a link in an indexed property located in a section$/) do
+  @link = @page.container.indexed_list['success'].indexed_link_element
+end