page-object 0.2.4 → 0.2.5

data/features/step_definitions/button_steps.rb

@@ -0,0 +1,23 @@
+When /^I click the button$/ do
+  @page.button_id
+end
+
+When /^I search for the button by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+When /^I search for the button by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+Then /^I should be able to click the button$/ do
+  @page.send "button_#{@how}"
+end
+
+When /^I find a button while the script is executing$/ do
+  @button = @page.button_element(:id => 'button_id')
+end
+
+Then /^I should be able to click the button element$/ do
+  @button.click
+end

data/features/step_definitions/check_box_steps.rb

@@ -0,0 +1,31 @@
+When /^I select the First check box$/ do
+  @page.check_cb_id
+end
+
+Then /^the First check box should be selected$/ do
+  @page.cb_id_checked?.should be_true
+end
+
+When /^I unselect the First check box$/ do
+  @page.uncheck_cb_id
+end
+
+Then /^the First check box should not be selected$/ do
+  @page.cb_id_checked?.should be_false
+end
+
+When /^I search for the check box by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+When /^I search for the check box by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+Then /^I should be able to check the check box$/ do
+  @page.send "check_cb_#{@how}".to_sym
+end
+
+When /^I select the first check box while the script is executing$/ do
+  @page.checkbox_element(:id => 'cb_id').check
+end

data/features/step_definitions/div_steps.rb

@@ -0,0 +1,15 @@
+When /^I get the text from the div$/ do
+  @text = @page.div_id
+end
+
+When /^I search for the div by "([^\"]*)"$/ do |how|
+  @text = @page.send "div_#{how}".to_sym
+end
+
+When /^I search for the div by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @text = @page.send "div_#{param1}_#{param2}".to_sym
+end
+
+When /^I get the text from a div while the script is executing$/ do
+  @text = @page.div_element(:id => 'div_id').text
+end

data/features/step_definitions/element_steps.rb

@@ -1,7 +1,3 @@
-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_element
 end

data/features/step_definitions/form_steps.rb

@@ -0,0 +1,15 @@
+Then /^I should be able to submit the form$/ do
+  @element.submit
+end
+
+When /^I locate the form by "([^\"]*)"$/ do |how|
+  @element = @page.send "form_#{how}_element"
+end
+
+When /^I locate the form using "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "form_#{param1}_#{param2}_element"
+end
+
+When /^I locate a form while the script is executing$/ do
+  @element = @page.form_element(:id => 'form_id')
+end

data/features/step_definitions/hidden_field_steps.rb

@@ -0,0 +1,23 @@
+When /^I retrieve the hidden field element$/ do
+  @element = @page.hidden_field_id_element
+end
+
+Then /^I should see the hidden field contains "([^\"]*)"$/ do |text|
+  @page.hidden_field_id.should == text
+end
+
+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|
+  @element.value.should == text
+end
+
+When /^I search for the hidden field by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "hidden_field_#{param1}_#{param2}_element"
+end
+
+When /^I find a hidden field while the script is executing$/ do
+  @element = @page.hidden_field_element(:id => 'hidden_field_id')
+end

data/features/step_definitions/image_steps.rb

@@ -0,0 +1,23 @@
+When /^I get the image element$/ do
+  @element = @page.image_id_image
+end
+
+Then /^the image should be "([^\"]*)" pixels wide$/ do |width|
+  @element.width.should == width.to_i
+end
+
+Then /^the image should be "([^\"]*)" pixels tall$/ do |height|
+  @element.height.should == height.to_i
+end
+
+When /^I get the image element by "([^\"]*)"$/ do |how|
+  @element = @page.send "image_#{how}_element"
+end
+
+When /^I get the image element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "image_#{param1}_#{param2}_element"
+end
+
+When /^I get the image element while the script is executing$/ do
+  @element = @page.image_element(:id => 'image_id')
+end

data/features/step_definitions/link_steps.rb

@@ -0,0 +1,20 @@
+When /^I select the link labeled "([^\"]*)"$/ do |text|
+  @page.google_search_id
+end
+
+When /^I search for the link by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+Then /^I should be able to select the link$/ do
+  @page.send "google_search_#{@how}".to_sym
+end
+
+When /^I select a link labeled "([^"]*)" and index "([^"]*)"$/ do |label, index|
+  @page.send "#{label.downcase}#{index}".to_sym
+end
+
+When /^I select a link while the script is executing$/ do
+  link = @page.link_element(:id => 'link_id')
+  link.click
+end

data/features/step_definitions/list_item_steps.rb

@@ -0,0 +1,15 @@
+When /^I get the text from the list item$/ do
+  @text = @page.li_id
+end
+
+When /^I search for the list item by "([^\"]*)"$/ do |how|
+  @text = @page.send "li_#{how}"
+end
+
+When /^I search for the list item by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @text = @page.send "li_#{param1}_#{param2}"
+end
+
+When /^I search for the list item while the script is executing$/ do
+  @text = @page.list_item_element(:id => 'li_id').text
+end

data/features/step_definitions/ordered_list_steps.rb

@@ -0,0 +1,15 @@
+When /^I get the first item from the ordered list$/ do
+  @element = @page.ol_id_element[0]
+end
+
+When /^I search for the ordered list by "([^\"]*)"$/ do |how|
+  @list = @page.send "ol_#{how}_element"
+end
+
+When /^I search for the ordered list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @list = @page.send "ol_#{param1}_#{param2}_element"
+end
+
+When /^I search for the ordered list while the script is executing$/ do
+  @list = @page.ordered_list_element(:id => 'ol_id')
+end

data/features/step_definitions/radio_button_steps.rb

@@ -0,0 +1,23 @@
+When /^I select the "([^\"]*)" radio button$/ do |how|
+  @page.send "select_#{how.downcase}_id".to_sym
+end
+
+Then /^the "([^\"]*)" radio button should be selected$/ do |how|
+  @page.send "#{how.downcase}_id_selected?".to_sym
+end
+
+When /^I search for the radio button by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+When /^I search for the radio button by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+When /^I select the radio button$/ do
+  @page.send "select_milk_#{@how}".to_sym
+end
+
+When /^I select the radio button while the script is executing$/ do
+  @page.radio_button_element(:id => 'milk_id').select
+end

data/features/step_definitions/select_list_steps.rb

@@ -0,0 +1,28 @@
+When /^I select "([^\"]*)" from the select list$/ do |text|
+  @page.sel_list_id = text
+end
+
+When /^I search for the select list by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+When /^I search for the select list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+Then /^I should be able to select "([^\"]*)"$/ do |value|
+  @page.send "sel_list_#{@how}=".to_sym, value
+end
+
+Then /^the value for the selected item should be "([^\"]*)"$/ do |value|
+  result = @page.send "sel_list_#{@how}".to_sym
+  result.should == value
+end
+
+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|
+  @select_list.select(value)
+end

data/features/step_definitions/span_steps.rb

@@ -0,0 +1,15 @@
+When /^I get the text from the span$/ do
+  @text = @page.span_id
+end
+
+When /^I search for the span by "([^\"]*)"$/ do |how|
+  @text = @page.send "span_#{how}".to_sym
+end
+
+When /^I search for the span by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @text = @page.send "span_#{param1}_#{param2}".to_sym
+end
+
+When /^I get the text from a span while the script is executing$/ do
+  @text = @page.span_element(:id => 'span_id').text
+end

data/features/step_definitions/table_cell_steps.rb

@@ -0,0 +1,11 @@
+When /^I search for the table cell by "([^\"]*)"$/ do |how|
+  @cell_data = @page.send "cell_#{how}"
+end
+
+When /^I retrieve a table cell element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @cell_data = @page.send "cell_#{param1}_#{param2}"
+end
+
+When /^I retrieve a table cell element while the script is executing$/ do
+  @cell_data = @page.cell_element(:id => 'cell_id').text
+end

data/features/step_definitions/table_steps.rb

@@ -12,3 +12,15 @@ end
 Then /^the cell data should be '([^"]*)'$/ do |expected|
   @cell_data.should == expected
 end
+
+When /^I retrieve a table element by "([^\"]*)"$/ do |how|
+  @element = @page.send "table_#{how}_element"
+end
+
+When /^I retrieve a table element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "table_#{param1}_#{param2}_element"
+end
+
+When /^I retrieve a table element while the script is executing$/ do
+  @element = @page.table_element(:id => 'table_id')
+end

data/features/step_definitions/text_area_steps.rb

@@ -0,0 +1,27 @@
+When /^I type "([^\"]*)" into the text area$/ do |text|
+  @page.text_area_id = text
+end
+
+Then /^the text area should contain "([^\"]*)"$/ do |expected_text|
+  @page.text_area_id.should == expected_text
+end
+
+When /^I search for the text area by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+When /^I search for the text area by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+Then /^I should be able to type "([^\"]*)" into the area$/ do |value|
+  @page.send "text_area_#{@how}=".to_sym, value
+end
+
+When /^I find a text area while the script is executing$/ do
+  @text_area = @page.text_area_element(:id => 'text_area_id')
+end
+
+Then /^I should be able to type "([^"]*)" into the area element$/ do |value|
+  @text_area.value = value
+end

data/features/step_definitions/text_field_steps.rb

@@ -0,0 +1,27 @@
+When /^I type "([^\"]*)" into the text field$/ do |text|
+  @page.text_field_id = text
+end
+
+Then /^the text field should contain "([^\"]*)"$/ do |expected_text|
+  @page.text_field_id.should == expected_text
+end
+
+When /^I search for the text field by "([^\"]*)"$/ do |how|
+  @how = how
+end
+
+When /^I search for the text field by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+Then /^I should be able to type "([^\"]*)" into the field$/ do |value|
+  @page.send "text_field_#{@how}=".to_sym, value
+end
+
+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|
+  @text_field.value = value
+end

data/features/step_definitions/unordered_list_steps.rb

@@ -0,0 +1,16 @@
+When /^I get the first item from the unordered list$/ do
+  @element = @page.ul_id_element[0]
+end
+
+When /^I search for the unordered list by "([^\"]*)"$/ do |how|
+  @list = @page.send "ul_#{how}_element"
+end
+
+When /^I search for the unordered list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @list = @page.send "ul_#{param1}_#{param2}_element"
+end
+
+When /^I search for the unordered list while the script is executing$/ do
+  @list = @page.unordered_list_element(:id => 'ul_id')
+end
+

data/features/table.feature

@@ -44,3 +44,7 @@ Feature: Table
     | param1 | param2 |
     | class  | index  |
     | name   | index  |
+
+  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"

data/features/table_cell.feature

@@ -38,3 +38,6 @@ Feature: Table Cell
     | class  | index  |
     | name   | index  |
 
+  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'

data/features/text_area.feature

@@ -31,3 +31,7 @@ Feature: Text Area
     | param1 | param2 |
     | class  | index  |
     | name   | index  |
+
+  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

data/features/text_field.feature

@@ -37,3 +37,7 @@ Feature: Text Fields
     When I retrieve a text field
     Then I should know it exists
     And I should know it is visible
+
+  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

data/features/unordered_list.feature

@@ -31,3 +31,8 @@ Feature: Unordered list
     | param1 | param2 |
     | class  | index  |
     | name   | index  |
+
+  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 the list items text should be "Item One"

data/lib/page-object.rb

@@ -1,6 +1,7 @@
 require 'page-object/version'
 require 'page-object/accessors'
 require 'page-object/platforms'
+require 'page-object/element_locators'
 
 #
 # Module that when included adds functionality to a page object.  This module
@@ -32,6 +33,8 @@ require 'page-object/platforms'
 #
 module PageObject
   include LoadsPlatform
+  include ElementLocators
+  
   # @return [Watir::Browser or Selenium::WebDriver::Driver] the platform browser passed to the constructor
   attr_reader :browser
   # @return [PageObject::WatirPageObject or PageObject::SeleniumPageObject] the platform page object
@@ -160,13 +163,15 @@ module PageObject
   #
   # @param [Hash] either :title or :url of the other window.  The url does not need to
   # be the entire url - it can just be the page name like index.html
+  # @param block if present the block is executed and then execution is returned to the
+  # calling window
   #
-  def attach_to_window(identifier)
+  def attach_to_window(identifier, &block)
     begin
-      platform.attach_to_window(identifier)
+      platform.attach_to_window(identifier, &block)
     rescue
       sleep 1
-      platform.attach_to_window(identifier)
+      platform.attach_to_window(identifier, &block)
     end
   end