RubyGems - page-object - Versions diffs - 0.2.1 → 0.2.2 - Mend

page-object 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

data/ChangeLog +9 -0
data/features/element.feature +8 -0
data/features/frames.feature +32 -7
data/features/html/nested_frame_1.html +1 -0
data/features/html/nested_frame_2.html +11 -0
data/features/html/nested_frame_3.html +14 -0
data/features/html/nested_frames.html +10 -0
data/features/step_definitions/element_steps.rb +4 -0
data/features/step_definitions/frames_steps.rb +58 -6
data/features/support/url_helper.rb +8 -0
data/lib/page-object.rb +0 -10
data/lib/page-object/accessors.rb +23 -0
data/lib/page-object/core_ext/string.rb +5 -0
data/lib/page-object/platforms/selenium/element.rb +35 -24
data/lib/page-object/platforms/selenium/page_object.rb +138 -18
data/lib/page-object/platforms/watir/element.rb +7 -0
data/lib/page-object/platforms/watir/page_object.rb +85 -45
data/lib/page-object/version.rb +1 -1
data/spec/page-object/accessors_spec.rb +7 -1
data/spec/page-object/elements/element_spec.rb +11 -0
data/spec/page-object/page-object_spec.rb +0 -13
data/spec/page-object/platforms/selenium/selenium_page_object_spec.rb +5 -0
metadata +13 -2

data/ChangeLog CHANGED Viewed

@@ -1,3 +1,12 @@
+=== Version 0.2.2 / 2011-07-31
+* Enhancements
+  * Can find frame by name
+  * Added #clear method to Element
+  * Removed #switch_to_from from PageObject
+  * Added #in_frame to Accessors to handle frame and iframe access
+* Fixes
+  * Clearing value from text_field before setting value on Selenium
 === Version 0.2.1 / 2011-07-29
 * Enhancements
   * Added ability to locate div by the contained text

data/features/element.feature ADDED Viewed

@@ -0,0 +1,8 @@
+Feature: Elements
+  Scenario: Clear an element
+    Given I am on the static elements page
+    When I type "abcDEF" into the text field
+    Then the text field should contain "abcDEF"
+    When I clear the text field
+    Then the text field should contain ""

data/features/frames.feature CHANGED Viewed

@@ -1,12 +1,37 @@
 Feature: Handling frames
-  Background:
+  Scenario: Accessing elements within the frame
     Given I am on the frame elements page
+    When I type "page-object" into the text field for frame 2 using "id"
+    Then I should verify "page-object" is in the text field for frame 2 using "id"
+    When I type "page-object" into the text field for frame 2 using "name"
+    Then I should verify "page-object" is in the text field for frame 2 using "name"
+    When I type "page-object" into the text field for frame 2 using "index"
+    Then I should verify "page-object" is in the text field for frame 2 using "index"
-  Scenario: Switching to a frame by id
-    When I switch to a frame using id "frame_2"
-    Then I should see "Frame 2" in the frame
+  Scenario: Switching between frames
+    Given I am on the frame elements page
+    When I type "page-object" into the text field for frame 2 using "id"
+    And I type "page-object" into the text field from frame 1 using "id"
+    Then I should verify "page-object" is in the text field for frame 2 using "id"
+    And I should verify "page-object" is in the text field for frame 1 using "id"
+  Scenario: Accessing elements within the frame
+    Given I am on the iframe elements page
+    When I type "page-object" into the text field for frame 2 using "id"
+    Then I should verify "page-object" is in the text field for frame 2 using "id"
+    When I type "page-object" into the text field for frame 2 using "name"
+    Then I should verify "page-object" is in the text field for frame 2 using "name"
+    When I type "page-object" into the text field for frame 2 using "index"
+    Then I should verify "page-object" is in the text field for frame 2 using "index"
-  Scenario: Switching to a frame by index
-    When I switch to a frame using index "1"
-    Then I should see "Frame 2" in the frame
+  Scenario: Switching between frames
+    Given I am on the iframe elements page
+    When I type "page-object" into the text field for frame 2 using "id"
+    And I type "page-object" into the text field from frame 1 using "id"
+    Then I should verify "page-object" is in the text field for frame 2 using "id"
+    And I should verify "page-object" is in the text field for frame 1 using "id"
+  Scenario: Nested frames
+    Given I am on the nested frame elements page
+    Then I should be able to click the nested link

data/features/html/nested_frame_1.html ADDED Viewed

	@@ -0,0 +1 @@
1	+ frame 1

data/features/html/nested_frame_2.html ADDED Viewed

@@ -0,0 +1,11 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html>
+  <head>
+    <title></title>
+  </head>
+  <body>
+    <p>
+      <iframe id="three" src="nested_frame_3.html"></iframe>
+    </p>
+  </body>
+</html>

data/features/html/nested_frame_3.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html>
+  <head>
+    <meta http-equiv="Content-type" content="text/html; charset=utf-8">
+    <title>
+      Title
+    </title>
+  </head>
+  <body>
+    <p>
+      <a id="four" href="success.html" target="_top">this link should open the page success page</a>
+    </p>
+  </body>
+</html>

data/features/html/nested_frames.html ADDED Viewed

@@ -0,0 +1,10 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
+<html>
+  <head>
+    <title></title>
+  </head>
+  <frameset cols="20%, 80%">
+    <frame id="one" src="nested_frame_1.html">
+    <frame id="two" src="nested_frame_2.html">
+  </frameset>
+</html>

data/features/step_definitions/element_steps.rb CHANGED Viewed

@@ -104,3 +104,7 @@ end
 When /^I retrieve an ordered list element$/ do
   @element = @page.ol_id_ordered_list
 end
+When /^I clear the text field$/ do
+  @page.text_field_id_text_field.clear
+end

data/features/step_definitions/frames_steps.rb CHANGED Viewed

@@ -1,5 +1,26 @@
 class FramePage
   include PageObject
+  in_frame(:index => 1) do |frame|
+    text_field(:text_field_2_index, :name => 'recieverElement', :frame => frame)
+  end
+  in_frame(:index => 0) do |frame|
+    text_field(:text_field_1_index, :name => 'senderElement', :frame => frame)
+  end
+  in_frame(:id => 'frame_2') do |frame|
+    text_field(:text_field_2_id, :name => 'recieverElement', :frame => frame)
+  end
+  in_frame(:id => 'frame_1') do |frame|
+    text_field(:text_field_1_id, :name => 'senderElement', :frame => frame)
+  end
+  in_frame(:name => 'frame2') do |frame|
+    text_field(:text_field_2_name, :name => 'recieverElement', :frame => frame)
+  end
+  in_frame(:name => 'frame1') do |frame|
+    text_field(:text_field_1_name, :name => 'senderElement', :frame => frame)
+  end
 end
 Given /^I am on the frame elements page$/ do
@@ -7,15 +28,46 @@ Given /^I am on the frame elements page$/ do
   @page.navigate_to(UrlHelper.frame_elements)
 end
-When /^I switch to a frame using id "([^"]*)"$/ do |id|
-  @page.switch_to_frame(id)
+Given /^I am on the iframe elements page$/ do
+  @page = FramePage.new(@browser)
+  @page.navigate_to(UrlHelper.iframe_elements)
+end
+When /^I type "([^"]*)" into the text field for frame 2 using "([^"]*)"$/ do |text, arg_type|
+  @page.send "text_field_2_#{arg_type}=".to_sym, text
+end
+Then /^I should verify "([^"]*)" is in the text field for frame 2 using "([^"]*)"$/ do |text, arg_type|
+  result = @page.send "text_field_2_#{arg_type}".to_sym
+  result.should == text
+end
+When /^I type "([^"]*)" into the text field from frame 1 using "([^"]*)"$/ do |text, arg_type|
+  @page.send "text_field_1_#{arg_type}=".to_sym, text
+end
+Then /^I should verify "([^"]*)" is in the text field for frame 1 using "([^"]*)"$/ do |text, arg_type|
+  result = @page.send "text_field_1_#{arg_type}".to_sym
+  result.should == text
+end
+class NestedFramePage
+  include PageObject
+  in_frame(:id => 'two') do |frame|
+    in_frame({:id => 'three'}, frame) do |nested_frame|
+      link(:nested_link, :id => 'four', :frame => nested_frame)
+    end
+  end
 end
-Then /^I should see "([^"]*)" in the frame$/ do |text|
-  @page.text.should include text
+Given /^I am on the nested frame elements page$/ do
+  @page = NestedFramePage.new(@browser)
+  @page.navigate_to(UrlHelper.nested_frame_elements)
 end
-When /^I switch to a frame using index "([^"]*)"$/ do |index|
-  @page.switch_to_frame(index.to_i)
+Then /^I should be able to click the nested link$/ do
+  @page.nested_link
+  @page.text.should include "Success"
 end

data/features/support/url_helper.rb CHANGED Viewed

@@ -16,5 +16,13 @@ module UrlHelper
     def frame_elements
       "#{files}/frames.html"
     end
+    def iframe_elements
+      "#{files}/iframes.html"
+    end
+    def nested_frame_elements
+      "#{files}/nested_frames.html"
+    end
   end
 end

data/lib/page-object.rb CHANGED Viewed

@@ -162,16 +162,6 @@ module PageObject
     platform.attach_to_window(identifier)
   end
-  #
-  # Switch to a frame within the current context.
-  #
-  # @param [String or Fixnum] you can pass the index (zero based) or id for the frame
-  # you wish to switch to.
-  #
-  def switch_to_frame(identifier)
-    platform.switch_to_frame identifier
-  end
   #
   # Refresh to current page
   #

data/lib/page-object/accessors.rb CHANGED Viewed

@@ -20,6 +20,29 @@ module PageObject
         platform.navigate_to url
       end
     end
+    #
+    # Identify an element as existing within a frame or iframe.  A frame parameter
+    # is passed to the block and must be passed to the other calls to PageObject.
+    # You can nest calls to in_frame by passing the frame to the next level.
+    #
+    # @example
+    #   in_frame(:id => 'frame_id') do |frame|
+    #     text_field(:first_name, :id => 'fname', :frame => frame)
+    #   end
+    #
+    # @param [Hash] identifier how we find the frame.  The valid keys are:
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    # @param frame passed from a previous call to in_frame.  Used to nest calls
+    # @param block that contains the calls to elements that exist inside the frame.
+    #
+    def in_frame(identifier, frame=nil, &block)
+      frame = [] if frame.nil?
+      frame << identifier
+      block.call(frame)
+    end
     #
     # adds three methods to the page object - one to set text in a text field,

data/lib/page-object/core_ext/string.rb ADDED Viewed

@@ -0,0 +1,5 @@
+class String
+  def is_integer
+    true if Integer(self) rescue false
+  end
+end

data/lib/page-object/platforms/selenium/element.rb CHANGED Viewed

@@ -137,31 +137,42 @@ module PageObject
           wait = Object::Selenium::WebDriver::Wait.new({:timeout => timeout, :message => message})
           wait.until &block
         end
-         #
-      # Waits until the block returns true
-      #
-      # @param [Integer] (defaults to: 5) seconds to wait before timing out
-      # @param [String] the message to display if the event timeouts
-      # @param the block to execute when the event occurrs
-      #
-      def wait_until(timeout=5, message=nil, &block)
-        wait = Object::Selenium::WebDriver::Wait.new({:timeout => timeout, :message => message})
-        wait.until &block
-      end
+        #
+        # Waits until the block returns true
+        #
+        # @param [Integer] (defaults to: 5) seconds to wait before timing out
+        # @param [String] the message to display if the event timeouts
+        # @param the block to execute when the event occurrs
+        #
+        def wait_until(timeout=5, message=nil, &block)
+          wait = Object::Selenium::WebDriver::Wait.new({:timeout => timeout, :message => message})
+          wait.until &block
+        end
-      #
-      # Send keystrokes to this element
-      #
-      # @param [String, Symbol, Array]
-      #
-      # Examples:
-      #
-      #     element.send_keys "foo"                     #=> value: 'foo'
-      #     element.send_keys "tet", :arrow_left, "s"   #=> value: 'test'
-      #     element.send_keys [:control, 'a'], :space   #=> value: ' '
-      #
-      # @see Selenium::WebDriver::Keys::KEYS
-      #
+        #
+        # Send keystrokes to this element
+        #
+        # @param [String, Symbol, Array]
+        #
+        # Examples:
+        #
+        #     element.send_keys "foo"                     #=> value: 'foo'
+        #     element.send_keys "tet", :arrow_left, "s"   #=> value: 'test'
+        #     element.send_keys [:control, 'a'], :space   #=> value: ' '
+        #
+        # @see Selenium::WebDriver::Keys::KEYS
+        #
+        def send_keys(*args)
+          @element.send_keys(*args)
+        end
+        #
+        # clear the contents of the element
+        #
+        def clear
+          @element.clear
+        end
       end
     end
   end

data/lib/page-object/platforms/selenium/page_object.rb CHANGED Viewed

@@ -1,4 +1,5 @@
 require 'page-object/elements'
+require 'page-object/core_ext/string'
 module PageObject
   module Platforms
@@ -104,14 +105,6 @@ module PageObject
           end
         end
-        #
-        # platform method to handle switching to a frame
-        # See PageObject#switch_to_frame
-        #
-        def switch_to_frame(identifier)
-          @browser.switch_to.frame(identifier)
-        end
         #
         # platform method to refresh the page
         # See PageObject#refresh
@@ -125,9 +118,13 @@ module PageObject
         # See PageObject::Accessors#text_field
         #
         def text_field_value_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'text'
           how, what = Elements::TextField.selenium_identifier_for identifier
-          @browser.find_element(how, what).attribute('value')
+          switch_to_frame(frame_identifiers)
+          text = @browser.find_element(how, what).attribute('value')
+          @browser.switch_to.default_content
+          text
         end
         #
@@ -135,9 +132,13 @@ module PageObject
         # See PageObject::Accessors#text_field
         #
         def text_field_value_set(identifier, value)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'text'
           how, what = Elements::TextField.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
+          @browser.find_element(how, what).clear
           @browser.find_element(how, what).send_keys(value)
+          @browser.switch_to.default_content
         end
         #
@@ -145,9 +146,12 @@ module PageObject
         # See PageObject::Accessors#text_field
         #
         def text_field_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'text'
           how, what = Elements::TextField.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::TextField.new(element, :platform => :selenium)
         end
@@ -156,9 +160,13 @@ module PageObject
         # See PageObject::Accessors#hidden_field
         #
         def hidden_field_value_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'hidden'
           how, what = Elements::HiddenField.selenium_identifier_for identifier
-          @browser.find_element(how, what).attribute('value')
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).attribute('value')
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -166,9 +174,12 @@ module PageObject
         # See PageObject::Accessors#hidden_field
         #
         def hidden_field_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'hidden'
           how, what = Elements::HiddenField.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Elements::HiddenField.new(element, :platform => :selenium)
         end
@@ -177,9 +188,12 @@ module PageObject
         # See PageObject::Accessors#text_area
         #
         def text_area_value_set(identifier, value)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'textarea'
           how, what = Elements::TextArea.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).send_keys(value)
+          @browser.switch_to.default_content
         end
         #
@@ -187,9 +201,13 @@ module PageObject
         # See PageObject::Accessors#text_area
         #
         def text_area_value_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'textarea'
           how, what = Elements::TextArea.selenium_identifier_for identifier
-          @browser.find_element(how, what).attribute('value')
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).attribute('value')
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -197,9 +215,12 @@ module PageObject
         # See PageObject::Accessors#text_area
         #
         def text_area_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'textarea'
           how, what = Elements::TextArea.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Elements::TextArea.new(element, :platform => :selenium)
         end
@@ -208,9 +229,13 @@ module PageObject
         # See PageObject::Accessors#select_list
         #
         def select_list_value_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'select'
           how, what = Elements::SelectList.selenium_identifier_for identifier
-          @browser.find_element(how, what).attribute('value')
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).attribute('value')
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -218,9 +243,12 @@ module PageObject
         # See PageObject::Accessors#select_list
         #
         def select_list_value_set(identifier, value)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'select'
           how, what = Elements::SelectList.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).send_keys(value)
+          @browser.switch_to.default_content
         end
         #
@@ -228,9 +256,12 @@ module PageObject
         # See PageObject::Accessors#select_list
         #
         def select_list_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'select'
           how, what = Elements::SelectList.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Elements::SelectList.new(element, :platform => :selenium)
         end
@@ -239,9 +270,12 @@ module PageObject
         # See PageObject::Accessors#link
         #
         def click_link_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, "a"
           how, what = Elements::Link.selenium_identifier_for identifier
+          switch_to_frame frame_identifiers
           @browser.find_element(how, what).click
+          @browser.switch_to.default_content
         end
         #
@@ -249,9 +283,12 @@ module PageObject
         # see PageObject::Accessors#link
         #
         def link_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, "a"
           how, what = Elements::Link.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Elements::Link.new(element, :platform => :selenium)
         end
@@ -260,9 +297,12 @@ module PageObject
         # See PageObject::Accessors#checkbox
         #
         def check_checkbox(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'checkbox'
           how, what = Elements::CheckBox.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).click unless @browser.find_element(how, what).selected?
+          @browser.switch_to.default_content
         end
         #
@@ -270,9 +310,12 @@ module PageObject
         # See PageObject::Accessors#checkbox
         #
         def uncheck_checkbox(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'checkbox'
           how, what = Elements::CheckBox.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).click if @browser.find_element(how, what).selected?
+          @browser.switch_to.default_content
         end
         #
@@ -280,9 +323,13 @@ module PageObject
         # See PageObject::Accessors#checkbox
         #
         def checkbox_checked?(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'checkbox'
           how, what = Elements::CheckBox.selenium_identifier_for identifier
-          @browser.find_element(how, what).selected?
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).selected?
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -290,9 +337,12 @@ module PageObject
         # See PageObject::Accessors#checkbox
         #
         def checkbox_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'checkbox'
           how, what = Elements::CheckBox.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Elements::CheckBox.new(element, :platform => :selenium)
         end
@@ -301,9 +351,12 @@ module PageObject
         # See PageObject::Accessors#radio_button
         #
         def select_radio(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'radio'
           how, what = Elements::RadioButton.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).click unless @browser.find_element(how, what).selected?
+          @browser.switch_to.default_content
         end
         #
@@ -311,9 +364,12 @@ module PageObject
         # See PageObject::Accessors#radio_button
         #
         def clear_radio(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'radio'
           how, what = Elements::RadioButton.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).click if @browser.find_element(how, what).selected?
+          @browser.switch_to.default_content
         end
         #
@@ -321,9 +377,13 @@ module PageObject
         # See PageObject::Accessors#radio_button
         #
         def radio_selected?(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'radio'
           how, what = Elements::RadioButton.selenium_identifier_for identifier
-          @browser.find_element(how, what).selected?
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).selected?
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -331,9 +391,12 @@ module PageObject
         # See PageObject::Accessors#radio_button
         #
         def radio_button_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'radio'
           how, what = Elements::RadioButton.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::RadioButton.new(element, :platform => :selenium)
         end
@@ -342,9 +405,13 @@ module PageObject
         # See PageObject::Accessors#div
         #
         def div_text_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'div'
           how, what = Elements::Div.selenium_identifier_for identifier
-          @browser.find_element(how, what).text
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).text
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -352,9 +419,12 @@ module PageObject
         # See PageObject::Accessors#div
         #
         def div_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'div'
           how, what = Elements::Div.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::Div.new(element, :platform => :selenium)
         end
@@ -363,9 +433,13 @@ module PageObject
         # See PageObject::Accessors#span
         #
         def span_text_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'span'
           how, what = Elements::Span.selenium_identifier_for identifier
-          @browser.find_element(how, what).text
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).text
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -373,9 +447,12 @@ module PageObject
         # See PageObject::Accessors#span
         #
         def span_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'span'
           how, what = Elements::Span.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::Span.new(element, :platform => :selenium)
         end
@@ -384,9 +461,12 @@ module PageObject
         # See PageObject::Accessors#button
         #
         def click_button_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'submit'
           how, what = Elements::Button.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           @browser.find_element(how, what).click
+          @browser.switch_to.default_content
         end
         #
@@ -394,9 +474,12 @@ module PageObject
         # See PageObject::Accessors#button
         #
         def button_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'input', :type => 'submit'
           how, what = Elements::Button.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::Button.new(element, :platform => :selenium)
         end
@@ -405,9 +488,12 @@ module PageObject
         # See PageObject::Accessors#table
         #
         def table_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'table'
           how, what = Elements::Table.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::Table.new(element, :platform => :selenium)
         end
@@ -416,9 +502,13 @@ module PageObject
         # See PageObject::Accessors#cell
         #
         def cell_text_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'td'
           how, what = Elements::TableCell.selenium_identifier_for identifier
-          @browser.find_element(how, what).text
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).text
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -426,9 +516,12 @@ module PageObject
         # See PageObject::Accessors#cell
         #
         def cell_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'td'
           how, what = Elements::TableCell.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::TableCell.new(element, :platform => :selenium)
         end
@@ -437,9 +530,12 @@ module PageObject
         # See PageObject::Accessors#image
         #
         def image_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'img'
           how, what = Elements::Image.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::Image.new(element, :platform => :selenium)
         end
@@ -448,9 +544,12 @@ module PageObject
         # See PageObject::Accessors#form
         #
         def form_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'form'
           how, what = Elements::Form.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::Form.new(element, :platform => :selenium)
         end
@@ -459,9 +558,13 @@ module PageObject
         # See PageObject::Accessors#list_item
         #
         def list_item_text_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'li'
           how, what = Elements::ListItem.selenium_identifier_for identifier
-          @browser.find_element(how, what).text
+          switch_to_frame(frame_identifiers)
+          value = @browser.find_element(how, what).text
+          @browser.switch_to.default_content
+          value
         end
         #
@@ -469,9 +572,12 @@ module PageObject
         # See PageObject::Accessors#list_item
         #
         def list_item_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'li'
           how, what = Elements::ListItem.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::ListItem.new(element, :platform => :selenium)
         end
@@ -480,9 +586,12 @@ module PageObject
         # See PageObject::Accessors#unordered_list
         #
         def unordered_list_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'ul'
           how, what = Elements::UnorderedList.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::UnorderedList.new(element, :platform => :selenium)
         end
@@ -491,9 +600,12 @@ module PageObject
         # See PageObject::Accessors#ordered_list
         #
         def ordered_list_for(identifier)
+          frame_identifiers = identifier.delete(:frame)
           identifier = add_tagname_if_needed identifier, 'ol'
           how, what = Elements::OrderedList.selenium_identifier_for identifier
+          switch_to_frame(frame_identifiers)
           element = @browser.find_element(how, what)
+          @browser.switch_to.default_content
           Object::PageObject::Elements::OrderedList.new(element, :platform => :selenium)
         end
@@ -518,6 +630,14 @@ module PageObject
           true
         end
+        def switch_to_frame(frame_identifiers)
+          if not frame_identifiers.nil?
+            frame_identifiers.each do |frame_id|
+              value = frame_id.values.first
+              @browser.switch_to.frame(value)
+            end
+          end
+        end
       end
     end
   end