page-object 0.2.5 → 0.3.0

data/features/nested_elements.feature

@@ -0,0 +1,73 @@
+Feature: Attributes on Elements
+
+  Background:
+    Given I am on the nested elements page
+
+  Scenario: Finding a link within a div
+    When I search for a link located in a div
+    Then I should be able to click the nested link
+    
+  Scenario: Finding a button within a div
+    When I search for a button located in a div
+    Then I should be able to click the nested button
+    
+  Scenario: Finding a text field within a div
+    When I search for a text field located in a div
+    Then I should be able to type "123abc" in the nested text field
+
+  Scenario: Finding a hidden field within a div
+    When I search for a hidden field located in a div
+    Then I should be able to see that the nested hidden field contains "LeanDog"
+    
+  Scenario: Finding a text area within a div
+    When I search for a text area located in a div
+    Then I should be able to type "abcdefg" in the nested text area
+
+  Scenario: Finding a select list within a div
+    When I search for a select list located in a div
+    Then I should be able to select "Test 2" in the nested select list
+
+  Scenario: Finding a checkbox within a div
+    When I search for a checkbox located in a div
+    Then I should be able to check the nested checkbox
+
+  Scenario: Finding a radio button witin a div
+    When I search for a radio button located in a div
+    Then I should be able to select the nested radio button
+
+  Scenario: Finding a div within a div
+    When I search for a div located in a div
+    Then I should see the text "page-object rocks!" in the nested div
+
+  Scenario: Finding a span within a div
+    When I search for a span located in a div
+    Then I should see the text "My alert" in the nested span
+
+  Scenario: Finding a table within a div
+    When I search for a table located in a div
+    Then the data for row "1" of the nested table should be "Data1" and "Data2"
+
+  Scenario: Finding a table cell within a div
+    When I search the second table cell located in a table in a div
+    Then the nested table cell should contain "Data2"
+
+  Scenario: Finding an image within a div
+    When I search for an image located in a div
+    Then the nested image should be "106" pixels wide
+    And the nested image should be "106" pixels tall
+  
+  Scenario: Finding a form within a div
+    When I search for a form located in a div
+    Then I should be able to submit the nested form
+    
+  Scenario: Finding an ordered list within a div
+    When I search for an ordered list located in a div
+    Then the first nested list items text should be "Number One"
+    
+  Scenario: Finding an unordered list within a div
+    When I search for an unordered list located in a div
+    Then the first nested list items text should be "Item One"
+  
+  Scenario: Finding a list item nested in an ordered list within a div
+    When I search for a list item nested in an ordered list in a div
+    Then I should see the nested list items text should be "Number One"

data/features/step_definitions/frames_steps.rb

@@ -66,7 +66,7 @@ Given /^I am on the nested frame elements page$/ do
   @page.navigate_to(UrlHelper.nested_frame_elements)
 end
 
-Then /^I should be able to click the nested link$/ do
+Then /^I should be able to click the link in the frame$/ do
   @page.nested_link
   @page.text.should include "Success"
 end

data/features/step_definitions/modal_dialog_steps.rb

@@ -0,0 +1,62 @@
+class ModalPage
+  include PageObject
+
+  button(:launch_modal, :id => 'launch_modal_button')
+end
+
+class ModalDialog
+  include PageObject
+
+  button(:close_window, :id => 'close_window')
+  button(:close_window_with_delay, :id => 'delayed_close')
+  button(:launch_another_modal, :id => 'launch_modal_button')
+end
+
+class AnotherModalDialog
+  include PageObject
+
+  button(:close_window, :id => 'close_window2')
+  button(:close_window_with_delay, :id => 'delayed_close2')
+end
+
+
+Given /^I am on the modal page$/ do
+  ModalPage.new(@browser).navigate_to(UrlHelper.modal)  
+end
+
+When /^I open a modal dialog$/ do
+  page = ModalPage.new(@browser)
+  page.modal_dialog do
+    page.launch_modal
+  end
+end
+
+Then /^I should be able to close the modal$/ do
+  dialog = ModalDialog.new(@browser)
+  dialog.attach_to_window(:title => 'Modal 1') do
+    dialog.close_window
+  end
+end
+
+When /^I open another modal dialog from that one$/ do
+  dialog = ModalDialog.new(@browser)
+  dialog.attach_to_window(:title => 'Modal 1') #do
+    dialog.modal_dialog #do
+#      dialog.launch_another_modal
+#    end
+    dialog.launch_another_modal
+#  end
+end
+
+Then /^I should be able to close both modals$/ do
+  pending
+  # another = AnotherModalDialog.new(@browser)
+  # another.attach_to_window(:title => 'Modal 2') do
+  #   another.close_window
+  # end
+
+  # dialog = ModalDialog.new(@browser)
+  # dialog.attach_to_window(:title => 'Modal 1') do
+  #   dialog.close_window
+  # end
+end

data/features/step_definitions/nested_elements_steps.rb

@@ -0,0 +1,165 @@
+class NestedElementsPage
+  include PageObject
+  
+  div(:outer_div, :id => 'div_id')
+  link(:nested_link) { |page| page.outer_div_element.link_element }
+  button(:nested_button) { |page| page.outer_div_element.button_element }
+  text_field(:nested_text_field) { |page| page.outer_div_element.text_field_element }
+  hidden_field(:nested_hidden_field) { |page| page.outer_div_element.hidden_field_element }
+  text_area(:nested_text_area) { |page| page.outer_div_element.text_area_element }
+  select_list(:nested_select_list) { |page| page.outer_div_element.select_list_element }
+  checkbox(:nested_checkbox) { |page| page.outer_div_element.checkbox_element }
+  radio_button(:nested_radio_button) { |page| page.outer_div_element.radio_button_element }
+  div(:nested_div) { |page| page.outer_div_element.div_element }
+  span(:nested_span) { |page| page.outer_div_element.span_element }
+  table(:nested_table) { |page| page.outer_div_element.table_element }
+  cell(:nested_cell) { |page| page.nested_table_element.cell_element(:index => 1) }
+  image(:nested_image) { |page| page.outer_div_element.image_element }
+  form(:nested_form) { |page| page.outer_div_element.form_element }
+  ordered_list(:nested_ordered_list) { |page| page.outer_div_element.ordered_list_element }
+  unordered_list(:nested_unordered_list) { |page| page.outer_div_element.unordered_list_element }
+  list_item(:nested_list_item) { |page| page.nested_ordered_list_element.list_item_element }
+end
+
+Given /^I am on the nested elements page$/ do
+  @page = NestedElementsPage.new(@browser)
+  @page.navigate_to(UrlHelper.nested_elements)
+end
+
+When /^I search for a link located in a div$/ do
+  @link = @page.nested_link_element
+end
+
+Then /^I should be able to click the nested link$/ do
+  @link.click
+end
+
+When /^I search for a button located in a div$/ do
+  @button = @page.nested_button_element
+end
+
+Then /^I should be able to click the nested button$/ do
+  @button.click
+end
+
+When /^I search for a text field located in a div$/ do
+  @text_field = @page.nested_text_field_element
+end
+
+Then /^I should be able to type "([^\"]*)" in the nested text field$/ do |value|
+  @text_field.value = value
+end
+
+When /^I search for a hidden field located in a div$/ do
+  @hidden_field = @page.nested_hidden_field_element
+end
+
+Then /^I should be able to see that the nested hidden field contains "([^\"]*)"$/ do |value|
+  @hidden_field.value.should == value
+end
+
+When /^I search for a text area located in a div$/ do
+  @text_area = @page.nested_text_area_element
+end
+
+Then /^I should be able to type "([^\"]*)" in the nested text area$/ do |value|
+  @text_area.value = value
+end
+
+When /^I search for a select list located in a div$/ do
+  @select_list = @page.nested_select_list_element
+end
+
+Then /^I should be able to select "([^\"]*)" in the nested select list$/ do |value|
+  @select_list.select value
+end
+
+When /^I search for a checkbox located in a div$/ do
+  @checkbox = @page.nested_checkbox_element
+end
+
+Then /^I should be able to check the nested checkbox$/ do
+  @checkbox.check
+end
+
+When /^I search for a radio button located in a div$/ do
+  @radio = @page.nested_radio_button_element
+end
+
+Then /^I should be able to select the nested radio button$/ do
+  @radio.select
+end
+
+When /^I search for a div located in a div$/ do
+  @div = @page.nested_div_element
+end
+
+Then /^I should see the text "([^\"]*)" in the nested div$/ do |value|
+  @div.text.should == value
+end
+
+When /^I search for a span located in a div$/ do
+  @span = @page.nested_span_element
+end
+
+Then /^I should see the text "([^\"]*)" in the nested span$/ do |value|
+  @span.text.should == value
+end
+
+When /^I search for a table located in a div$/ do
+  @table = @page.nested_table_element
+end
+
+Then /^the data for row "([^\"]*)" of the nested 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 div$/ do
+  @cell = @page.nested_cell_element
+end
+
+Then /^the nested table cell should contain "([^"]*)"$/ do |value|
+  @cell.text.should == value
+end
+
+When /^I search for an image located in a div$/ do
+  @image = @page.nested_image_element
+end
+
+Then /^the nested image should be "([^"]*)" pixels wide$/ do |width|
+  @image.width.should == width.to_i  
+end
+
+Then /^the nested image should be "([^"]*)" pixels tall$/ do |height|
+  @image.height.should == height.to_i
+end
+
+When /^I search for a form located in a div$/ do
+  @form = @page.nested_form_element
+end
+
+Then /^I should be able to submit the nested form$/ do
+  @form.submit
+end
+
+When /^I search for an ordered list located in a div$/ do
+  @list = @page.nested_ordered_list_element
+end
+
+Then /^the first nested list items text should be "([^"]*)"$/ do |value|
+  @list[0].text.should == value
+end
+
+When /^I search for an unordered list located in a div$/ do
+  @list = @page.nested_unordered_list_element
+end
+
+When /^I search for a list item nested in an ordered list in a div$/ do
+  @li = @page.nested_list_item_element
+end
+
+Then /^I should see the nested list items text should be "([^"]*)"$/ do |value|
+  @li.text.should == value
+end

data/features/support/page.rb

@@ -170,3 +170,4 @@ class Page
   
   link(:open_window, :text => 'New Window')
 end
+

data/features/support/url_helper.rb

@@ -24,5 +24,13 @@ module UrlHelper
     def nested_frame_elements
       "#{files}/nested_frames.html"
     end
+    
+    def nested_elements
+      "#{files}/nested_elements.html"
+    end
+    
+    def modal
+      "#{files}/modal.html"
+    end
   end
 end

data/lib/page-object.rb

@@ -2,6 +2,7 @@ require 'page-object/version'
 require 'page-object/accessors'
 require 'page-object/platforms'
 require 'page-object/element_locators'
+require 'page-object/nested_elements'
 
 #
 # Module that when included adds functionality to a page object.  This module
@@ -153,6 +154,31 @@ module PageObject
     platform.prompt(answer, &block)
   end
   
+  #
+  # Override the normal showModalDialog call is it opens a window instead
+  # of a dialog.  You will need to attach to the new window in order to
+  # continue.
+  #
+  # @example
+  #   @page.modal_dialog do
+  #     @page.action_that_spawns_the_modal
+  #   end
+  #
+  # @param block a block that contains the call that will cause the modal dialog.
+  #
+  def modal_dialog(&block)
+    script =
+    %Q{
+      window.showModalDialog = function(sURL, vArguments, sFeatures) {
+        window.dialogArguments = vArguments;
+        modalWin = window.open(sURL, 'modal', sFeatures);
+        return modalWin;
+      }
+    }
+    browser.execute_script script
+    yield if block_given?
+  end
+  
   #
   # Attach to a running window.  You can locate the window using either
   # the window's title or url.  If it failes to connect to a window it will

data/lib/page-object/accessors.rb

@@ -69,15 +69,15 @@ module PageObject
     #
     def text_field(name, identifier=nil, &block)
       define_method(name) do
-        return platform.text_field_value_for identifier.clone unless block
+        return platform.text_field_value_for identifier.clone unless block_given?
         self.send("#{name}_element").value
       end
       define_method("#{name}=") do |value|
-        return platform.text_field_value_set(identifier.clone, value) unless block
+        return platform.text_field_value_set(identifier.clone, value) unless block_given?
         self.send("#{name}_element").value = value
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.text_field_for(identifier.clone)
       end
       alias_method "#{name}_text_field".to_sym, "#{name}_element".to_sym
@@ -106,11 +106,11 @@ module PageObject
     #
     def hidden_field(name, identifier=nil, &block)
       define_method(name) do
-        return platform.hidden_field_value_for identifier.clone unless block
+        return platform.hidden_field_value_for identifier.clone unless block_given?
         self.send("#{name}_element").value
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.hidden_field_for(identifier.clone)
       end
       alias_method "#{name}_hidden_field".to_sym, "#{name}_element".to_sym
@@ -139,15 +139,15 @@ module PageObject
     #
     def text_area(name, identifier=nil, &block)
       define_method(name) do
-        return platform.text_area_value_for identifier.clone unless block
+        return platform.text_area_value_for identifier.clone unless block_given?
         self.send("#{name}_element").value
       end
       define_method("#{name}=") do |value|
-        return platform.text_area_value_set(identifier.clone, value) unless block
+        return platform.text_area_value_set(identifier.clone, value) unless block_given?
         self.send("#{name}_element").value = value
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.text_area_for(identifier.clone)
       end
       alias_method "#{name}_text_area".to_sym, "#{name}_element".to_sym
@@ -176,15 +176,15 @@ module PageObject
     #
     def select_list(name, identifier=nil, &block)
       define_method(name) do
-        return platform.select_list_value_for identifier.clone unless block
+        return platform.select_list_value_for identifier.clone unless block_given?
         self.send("#{name}_element").value
       end
       define_method("#{name}=") do |value|
-        return platform.select_list_value_set(identifier.clone, value) unless block
+        return platform.select_list_value_set(identifier.clone, value) unless block_given?
         self.send("#{name}_element").select(value)
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.select_list_for(identifier.clone)
       end
       alias_method "#{name}_select_list".to_sym, "#{name}_element".to_sym
@@ -215,11 +215,11 @@ module PageObject
     #
     def link(name, identifier=nil, &block)
       define_method(name) do
-        return platform.click_link_for identifier.clone unless block
+        return platform.click_link_for identifier.clone unless block_given?
         self.send("#{name}_element").click
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.link_for(identifier.clone)
       end
       alias_method "#{name}_link".to_sym, "#{name}_element".to_sym
@@ -246,19 +246,19 @@ module PageObject
     #
     def checkbox(name, identifier=nil, &block)
       define_method("check_#{name}") do
-        return platform.check_checkbox(identifier.clone) unless block
+        return platform.check_checkbox(identifier.clone) unless block_given?
         self.send("#{name}_element").check
       end
       define_method("uncheck_#{name}") do
-        return platform.uncheck_checkbox(identifier.clone) unless block
+        return platform.uncheck_checkbox(identifier.clone) unless block_given?
         self.send("#{name}_element").uncheck
       end
       define_method("#{name}_checked?") do
-        return platform.checkbox_checked?(identifier.clone) unless block
+        return platform.checkbox_checked?(identifier.clone) unless block_given?
         self.send("#{name}_element").checked?
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.checkbox_for(identifier.clone)
       end
       alias_method "#{name}_checkbox".to_sym, "#{name}_element".to_sym
@@ -286,19 +286,19 @@ module PageObject
     #
     def radio_button(name, identifier=nil, &block)
       define_method("select_#{name}") do
-        return platform.select_radio(identifier.clone) unless block
+        return platform.select_radio(identifier.clone) unless block_given?
         self.send("#{name}_element").select
       end
       define_method("clear_#{name}") do
-        return platform.clear_radio(identifier.clone) unless block
+        return platform.clear_radio(identifier.clone) unless block_given?
         self.send("#{name}_element").clear
       end
       define_method("#{name}_selected?") do
-        return platform.radio_selected?(identifier.clone) unless block
+        return platform.radio_selected?(identifier.clone) unless block_given?
         self.send("#{name}_element").selected?
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.radio_button_for(identifier.clone)
       end
       alias_method "#{name}_radio_button".to_sym, "#{name}_element".to_sym
@@ -326,11 +326,11 @@ module PageObject
     #
     def button(name, identifier=nil, &block)
       define_method(name) do
-        return platform.click_button_for identifier.clone unless block
+        return platform.click_button_for identifier.clone unless block_given?
         self.send("#{name}_element").click
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.button_for(identifier.clone)
       end
       alias_method "#{name}_button".to_sym, "#{name}_element".to_sym
@@ -357,11 +357,11 @@ module PageObject
     #
     def div(name, identifier=nil, &block)
       define_method(name) do
-        return platform.div_text_for identifier.clone unless block
+        return platform.div_text_for identifier.clone unless block_given?
         self.send("#{name}_element").text
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.div_for(identifier.clone)
       end
       alias_method "#{name}_div".to_sym, "#{name}_element".to_sym
@@ -387,11 +387,11 @@ module PageObject
     #
     def span(name, identifier=nil, &block)
       define_method(name) do
-        return platform.span_text_for identifier.clone unless block
+        return platform.span_text_for identifier.clone unless block_given?
         self.send("#{name}_element").text
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.span_for(identifier.clone)
       end
       alias_method "#{name}_span".to_sym, "#{name}_element".to_sym
@@ -416,7 +416,7 @@ module PageObject
     #
     def table(name, identifier=nil, &block)
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.table_for(identifier.clone)
       end
       alias_method "#{name}_table".to_sym, "#{name}_element".to_sym
@@ -443,11 +443,11 @@ module PageObject
     #
     def cell(name, identifier=nil, &block)
       define_method("#{name}") do
-        return platform.cell_text_for identifier.clone unless block
+        return platform.cell_text_for identifier.clone unless block_given?
         self.send("#{name}_element").text
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.cell_for(identifier.clone)
       end
       alias_method "#{name}_cell".to_sym, "#{name}_element".to_sym
@@ -472,7 +472,7 @@ module PageObject
     #
     def image(name, identifier=nil, &block)
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.image_for(identifier.clone)
       end
       alias_method "#{name}_image".to_sym, "#{name}_element".to_sym
@@ -496,7 +496,7 @@ module PageObject
     #
     def form(name, identifier=nil, &block)
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.form_for(identifier.clone)
       end
       alias_method "#{name}_form".to_sym, "#{name}_element".to_sym
@@ -522,11 +522,11 @@ module PageObject
     #
     def list_item(name, identifier=nil, &block)
       define_method(name) do
-        return platform.list_item_text_for identifier.clone unless block
+        return platform.list_item_text_for identifier.clone unless block_given?
         self.send("#{name}_element").text
       end
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.list_item_for(identifier.clone)
       end
       alias_method "#{name}_list_item".to_sym, "#{name}_element".to_sym
@@ -551,7 +551,7 @@ module PageObject
     #
     def unordered_list(name, identifier=nil, &block)
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.unordered_list_for(identifier.clone)
       end
       alias_method "#{name}_unordered_list".to_sym, "#{name}_element".to_sym
@@ -576,7 +576,7 @@ module PageObject
     #
     def ordered_list(name, identifier=nil, &block)
       define_method("#{name}_element") do
-        return call_block(&block) if block
+        return call_block(&block) if block_given?
         platform.ordered_list_for(identifier.clone)
       end
       alias_method "#{name}_ordered_list".to_sym, "#{name}_element".to_sym