page-object 0.2 → 0.2.1

data/features/step_definitions/accessor_steps.rb

@@ -119,7 +119,7 @@ When /^I search for the radio button by "([^"]*)" and "([^"]*)"$/ do |param1, pa
   @how = "#{param1}_#{param2}"
 end
 
-When /^I select the radio button$/ do 
+When /^I select the radio button$/ do
   @page.send "select_milk_#{@how}".to_sym
 end
 
@@ -217,7 +217,7 @@ Then /^I should see the hidden field contains "([^\"]*)"$/ do |text|
 end
 
 When /^I search for the hidden field by "([^\"]*)"$/ do |how|
-    @element = @page.send "hidden_field_#{how}_hidden_field"
+  @element = @page.send "hidden_field_#{how}_hidden_field"
 end
 
 Then /^hidden field element should contains "([^\"]*)"$/ do |text|

data/features/step_definitions/async_steps.rb

@@ -1,5 +1,5 @@
 def success
-  
+
 end
 
 Then /^I should be able to wait until it is present$/ do

data/features/step_definitions/element_steps.rb

@@ -41,7 +41,7 @@ end
 When /^I retrieve table cell$/ do
   @element = @page.cell_id_cell
 end
-  
+
 When /^I locate the form$/ do
   @element = @page.form_id_form
 end

data/features/step_definitions/frames_steps.rb

@@ -0,0 +1,21 @@
+class FramePage
+  include PageObject
+end
+
+Given /^I am on the frame elements page$/ do
+  @page = FramePage.new(@browser)
+  @page.navigate_to(UrlHelper.frame_elements)
+end
+
+When /^I switch to a frame using id "([^"]*)"$/ do |id|
+  @page.switch_to_frame(id)
+end
+
+Then /^I should see "([^"]*)" in the frame$/ do |text|
+  @page.text.should include text
+end
+
+When /^I switch to a frame using index "([^"]*)"$/ do |index|
+  @page.switch_to_frame(index.to_i)
+end
+

data/features/step_definitions/page_level_actions_steps.rb

@@ -1,6 +1,5 @@
-
 Then /^the page should contain the text "([^\"]*)"$/ do |text|
-  @page.text.should include text  
+  @page.text.should include text
 end
 
 Then /^the page should contain the html "([^\"]*)"$/ do |html|
@@ -49,3 +48,26 @@ Then /^I should be able to get the message and default value$/ do
   @msg[:default_value].should == 'John Doe'
 end
 
+When /^I open a second window$/ do
+  @page.open_window
+end
+
+class SecondPage
+  include PageObject
+end
+
+Then /^I should be able to attach to a page object using title$/ do
+  @second_page = SecondPage.new(@browser)
+  @second_page.attach_to_window(:title => "Success")
+end
+
+Then /^I should be able to attach to a page object using url$/ do
+  @second_page = SecondPage.new(@browser)
+  @second_page.attach_to_window(:url => "success.html")
+end
+
+Then /^I should be able to refresh the page$/ do
+  @page.refresh
+end
+
+

data/features/step_definitions/page_traversal_steps.rb

@@ -1,4 +1,3 @@
-
 Given /^I am on the static elements page$/ do
   @page = Page.new(@browser)
   @page.navigate_to(UrlHelper.static_elements)

data/features/support/env.rb

@@ -6,13 +6,27 @@ require 'selenium-webdriver'
 
 require 'page-object'
 
+
+
 Before do
-  @browser = Watir::Browser.new :firefox if ENV['DRIVER'] == 'WATIR'
-  @browser = Selenium::WebDriver.for :firefox if ENV['DRIVER'] == 'SELENIUM'
+  @browser = PageObject::PersistantBrowser.get_browser
 end
-
-After do |s|
-  @browser.close
+at_exit do
+  PageObject::PersistantBrowser.quit
 end
 
-
+module PageObject
+  module PersistantBrowser
+    @@browser = false
+    def self.get_browser 
+      if !@@browser 
+         @@browser =  Watir::Browser.new :firefox if ENV['DRIVER'] == 'WATIR' 
+         @@browser =  Selenium::WebDriver.for :firefox if ENV['DRIVER'] == 'SELENIUM'
+      end
+      return @@browser
+    end
+    def self.quit
+      @@browser.quit
+    end
+  end  
+end

data/features/support/page.rb

@@ -50,7 +50,7 @@ class Page
   link(:google_search_href, :href => "success.html")
   link(:google_search_text, :text => "Google Search")
   link(:google_search_index, :index => 0)
-  
+
   select_list(:sel_list_id, :id => "sel_list_id")
   select_list(:sel_list_class, :class => "sel_list_class")
   select_list(:sel_list_index, :index => 0)
@@ -76,17 +76,18 @@ class Page
   radio_button(:milk_xpath, :xpath => "//input[@type='radio']")
   radio_button(:milk_class_index, :class => "milk_class", :index => 0)
   radio_button(:milk_name_index, :name => "milk_name", :index => 0)
-  
+
   radio_button(:butter_id, :id => 'butter_id')
-  
+
   div(:div_id, :id => 'div_id')
   div(:div_name, :name => 'div_name')
   div(:div_class, :class => 'div_class')
+  div(:div_text, :text => 'page-object rocks!')
   div(:div_index, :index => 0)
   div(:div_xpath, :xpath => '//div')
   div(:div_class_index, :class => "div_class", :index => 0)
   div(:div_name_index, :name => "div_name", :index => 0)
-  
+
   span(:span_id, :id => 'span_id')
   span(:span_name, :name => 'span_name')
   span(:span_class, :class => 'span_class')
@@ -94,7 +95,7 @@ class Page
   span(:span_xpath, :xpath => '//span')
   span(:span_class_index, :class => "span_class", :index => 0)
   span(:span_name_index, :name => "span_name", :index => 0)
-  
+
   table(:table_id, :id => 'table_id')
   table(:table_name, :name => 'table_name')
   table(:table_class, :class => 'table_class')
@@ -102,7 +103,7 @@ class Page
   table(:table_xpath, :xpath => '//table')
   table(:table_class_index, :class => "table_class", :index => 0)
   table(:table_name_index, :name => "table_name", :index => 0)
-  
+
   cell(:cell_id, :id => 'cell_id')
   cell(:cell_name, :name => 'cell_name')
   cell(:cell_class, :class => 'cell_class')
@@ -110,7 +111,7 @@ class Page
   cell(:cell_xpath, :xpath => '//table//tr[2]//td[2]')
   cell(:cell_class_index, :class => "cell_class", :index => 0)
   cell(:cell_name_index, :name => "cell_name", :index => 0)
-  
+
   button(:button_id, :id => 'button_id')
   button(:button_name, :name => 'button_name')
   button(:button_class, :class => 'button_class')
@@ -119,7 +120,7 @@ class Page
   button(:button_text, :text => 'Click Me')
   button(:button_class_index, :class => "button_class", :index => 0)
   button(:button_name_index, :name => "button_name", :index => 0)
-  
+
   image(:image_id, :id => 'image_id')
   image(:image_name, :name => 'image_name')
   image(:image_class, :class => 'image_class')
@@ -135,7 +136,7 @@ class Page
   form(:form_xpath, :xpath => '//form')
   form(:form_class_index, :class => "form_class", :index => 0)
   form(:form_name_index, :name => "form_name", :index => 0)
-  
+
   list_item(:li_id, :id => 'li_id')
   list_item(:li_name, :name => 'li_name')
   list_item(:li_class, :class => 'li_class')
@@ -143,7 +144,7 @@ class Page
   list_item(:li_xpath, :xpath => '//li[1]')
   list_item(:li_class_index, :class => "li_class", :index => 0)
   list_item(:li_name_index, :name => "li_name", :index => 0)
-  
+
   unordered_list(:ul_id, :id => 'ul_id')
   unordered_list(:ul_name, :name => 'ul_name')
   unordered_list(:ul_class, :class => 'ul_class')
@@ -159,8 +160,10 @@ class Page
   ordered_list(:ol_xpath, :xpath => '//ol')
   ordered_list(:ol_class_index, :class => "ol_class", :index => 0)
   ordered_list(:ol_name_index, :name => "ol_name", :index => 0)
-  
+
   button(:alert_button, :id => 'alert_button')
   button(:confirm_button, :id => 'confirm_button')
   button(:prompt_button, :id => 'prompt_button')
+  
+  link(:open_window, :text => 'New Window')
 end

data/features/support/url_helper.rb

@@ -12,5 +12,9 @@ module UrlHelper
     def static_elements
       "#{files}/static_elements.html"
     end
+    
+    def frame_elements
+      "#{files}/frames.html"      
+    end
   end
 end

data/features/table.feature

@@ -2,19 +2,19 @@ Feature: Table
   In order to interact with tables
   Testers will need access and interrogation ability
 
-  
+
   Background:
     Given I am on the static elements page
-  
+
   Scenario: Retrieve a table
     When I retrieve a table element
     Then I should know it is visible
-    
+
   @watir_only
   Scenario: Determine if a table exists
     When I retrieve a table element
     Then I should know it exists
-    
+
   Scenario: Retrieve the data from a table
     When I retrieve a table element
     Then the data for row "1" should be "Data1" and "Data2"
@@ -23,7 +23,7 @@ Feature: Table
     And each row should contain "Data"
     And row "1" should have "2" columns
     And each column should contain "Data"
-  
+
   Scenario Outline: Locating table cells on the Page
     When I retrieve a table element by "<search_by>"
     Then the data for row "1" should be "Data1" and "Data2"
@@ -32,7 +32,7 @@ Feature: Table
     | search_by |
     | id        |
     | class     |
-    | xpath     |  
+    | xpath     |
     | index     |
     | name      |
 
@@ -41,6 +41,6 @@ Feature: Table
     Then the data for row "1" should be "Data1" and "Data2"
 
   Scenarios:
-    | param1  | param2  |
-    | class   | index   |
-    | name    | index   |
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |

data/features/table_cell.feature

@@ -7,7 +7,7 @@ Feature: Table Cell
   Scenario: Retrieving the text from a table cell
     When I retrieve the data from the table cell
     Then the cell data should be 'Data4'
-  
+
   Scenario Outline: Locating table cells on the Page
     When I search for the table cell by "<search_by>"
     Then the cell data should be 'Data4'
@@ -16,9 +16,9 @@ Feature: Table Cell
     | search_by |
     | id        |
     | class     |
-    | xpath     |  
+    | xpath     |
     | name      |
-  
+
   @watir_only
   Scenario Outline: Locating table cells on the Page with watir
     When I search for the table cell by "<search_by>"
@@ -33,7 +33,7 @@ Feature: Table Cell
     Then the cell data should be 'Data4'
 
   Scenarios:
-    | param1  | param2  |
-    | class   | index   |
-    | name    | index   |
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |
 

data/features/text_area.feature

@@ -1,9 +1,9 @@
 Feature: Text Area
 
-  
+
   Background:
     Given I am on the static elements page
-  
+
   Scenario: Setting and getting a value from a text area
     When I type "abcdefghijklmnop" into the text area
     Then the text area should contain "abcdefghijklmnop"
@@ -17,7 +17,7 @@ Feature: Text Area
     | id        |
     | class     |
     | name      |
-    | xpath     |  
+    | xpath     |
     | css       |
     | tag_name  |
     | index     |
@@ -28,6 +28,6 @@ Feature: Text Area
     Then I should be able to type "I found it" into the area
 
   Scenarios:
-    | param1  | param2  |
-    | class   | index   |
-    | name    | index   |
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |

data/features/text_field.feature

@@ -2,10 +2,10 @@ Feature: Text Fields
   In order to interact with text fields
   Testers will need access and interrogation ability
 
-  
+
   Background:
     Given I am on the static elements page
-  
+
   Scenario: Setting and getting a value from a text field
     When I type "abcDEF" into the text field
     Then the text field should contain "abcDEF"
@@ -19,19 +19,19 @@ Feature: Text Fields
     | id        |
     | class     |
     | name      |
-    | xpath     |  
+    | xpath     |
     | css       |
     | tag_name  |
     | index     |
-    
+
   Scenario Outline: Locating a text field using multiple parameters
     When I search for the text field by "<param1>" and "<param2>"
     Then I should be able to type "I found it" into the field
 
   Scenarios:
-    | param1  | param2  |
-    | class   | index   |
-    | name    | index   |
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |
 
   Scenario: Retrieve a text field
     When I retrieve a text field

data/features/unordered_list.feature

@@ -2,7 +2,7 @@ Feature: Unordered list
 
   Background:
     Given I am on the static elements page
-  
+
   Scenario: Getting the first element from the unordered list
     When I get the first item from the unordered list
     Then the list items text should be "Item One"
@@ -13,12 +13,12 @@ Feature: Unordered list
     Then the list items text should be "Item One"
     And the list should contain 3 items
     And each item should contain "Item"
-  
+
   Scenarios:
     | search_by |
     | id        |
     | class     |
-    | xpath     |  
+    | xpath     |
     | index     |
     | name      |
 
@@ -28,6 +28,6 @@ Feature: Unordered list
     Then the list items text should be "Item One"
 
   Scenarios:
-    | param1  | param2  |
-    | class   | index   |
-    | name    | index   |
+    | param1 | param2 |
+    | class  | index  |
+    | name   | index  |

data/lib/page-object.rb

@@ -1,6 +1,6 @@
-
 require 'page-object/version'
 require 'page-object/accessors'
+require 'page-object/platforms'
 
 #
 # Module that when included adds functionality to a page object.  This module
@@ -31,6 +31,7 @@ require 'page-object/accessors'
 # @see PageObject::Accessors to see what class level methods are added to this module at runtime.
 #
 module PageObject
+  include LoadsPlatform
   # @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
@@ -52,7 +53,7 @@ module PageObject
   def self.included(cls)
     cls.extend PageObject::Accessors
   end
-  
+
   #
   # navigate to the provided url
   #
@@ -61,7 +62,7 @@ module PageObject
   def navigate_to(url)
     platform.navigate_to(url)
   end
-  
+
   #
   # Returns the text of the current page
   #
@@ -82,7 +83,7 @@ module PageObject
   def title
     platform.title
   end
-  
+
   #
   # Wait until the block returns true or times out
   #
@@ -98,7 +99,7 @@ module PageObject
   def wait_until(timeout = 30, message = nil, &block)
     platform.wait_until(timeout, message, &block)
   end
-  
+
   #
   # Override the normal alert popup so it does not occurr.
   #
@@ -113,7 +114,7 @@ module PageObject
   def alert(&block)
     platform.alert(&block)
   end
-  
+
   #
   # Override the normal confirm popup so it does not occurr.
   #
@@ -129,7 +130,7 @@ module PageObject
   def confirm(response, &block)
     platform.confirm(response, &block)
   end
-  
+
   #
   # Override the normal promp popup so it does not occurr.
   #
@@ -146,18 +147,41 @@ module PageObject
   def prompt(answer, &block)
     platform.prompt(answer, &block)
   end
+  
+  #
+  # Attach to a running window.  You can locate the window using either
+  # the window's title or url.
+  #
+  # @example
+  #     page.attach_to_window(:title => "other window's title")
+  #
+  # @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
+  #
+  def attach_to_window(identifier)
+    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
+  #
+  def refresh
+    platform.refresh
+  end
 
   private
 
   def include_platform_driver(browser)
-    if browser.is_a? Watir::Browser
-      require 'page-object/watir_page_object'
-      @platform = PageObject::WatirPageObject.new(browser)
-    elsif browser.is_a? Selenium::WebDriver::Driver
-      require 'page-object/selenium_page_object'
-      @platform = PageObject::SeleniumPageObject.new(browser)
-    else
-      raise ArgumentError, "expect Watir::Browser or Selenium::WebDriver::Driver"
-    end
+    @platform = load_platform(browser, PageObject::Platforms.get)
   end
 end