meeane-page-object 0.1.8

data/spec/page-object/elements/selenium_element_spec.rb

@@ -0,0 +1,172 @@
+require 'page-object/elements'
+require 'selenium-webdriver'
+
+
+describe "Element for Selenium" do
+  before(:each) do
+    @selenium_driver = double('selenium')
+    @selenium_element = ::PageObject::Elements::Element.new(@selenium_driver, :platform => :selenium_webdriver)
+  end
+
+  it "should know when it is visible" do
+    @selenium_driver.should_receive(:displayed?).and_return(true)
+    @selenium_element.visible?.should == true
+  end
+
+  it "should know when it is not visible" do
+    @selenium_driver.should_receive(:displayed?).and_return(false)
+    @selenium_element.visible?.should == false
+  end
+
+  it "should know when it exists" do
+    @selenium_driver.should_receive(:nil?).and_return(false)
+    @selenium_element.exists?.should == true
+  end
+
+  it "should know when it does not exist" do
+    @selenium_element = ::PageObject::Elements::Element.new(nil, :platform => :selenium_webdriver)
+    @selenium_element.exists?.should == false
+  end
+
+  it "should flash an element" do
+    bridge = double('bridge')
+    @selenium_driver.should_receive(:attribute).and_return('blue')
+    @selenium_driver.should_receive(:instance_variable_get).and_return(bridge)
+    bridge.should_receive(:executeScript).exactly(10).times
+    @selenium_element.flash
+  end
+
+  it "should be able to return the text contained in the element" do
+    @selenium_driver.should_receive(:text).and_return("my text")
+    @selenium_element.text.should == "my text"
+  end
+
+  it "should know when it is equal to another" do
+    @selenium_driver.should_receive(:==).and_return(true)
+    @selenium_element.should == @selenium_element
+  end
+
+  it "should return its tag name" do
+    @selenium_driver.should_receive(:tag_name).and_return("h1")
+    @selenium_element.tag_name.should == "h1"
+  end
+
+  it "should know its value" do
+    @selenium_driver.should_receive(:attribute).with('value').and_return("value")
+    @selenium_element.value.should == "value"
+  end
+
+  it "should know how to retrieve the value of an attribute" do
+    @selenium_driver.should_receive(:attribute).and_return(true)
+    @selenium_element.attribute('readonly').should be true
+  end
+
+  it "should be clickable" do
+    @selenium_driver.should_receive(:click)
+    @selenium_element.click
+  end
+
+  it "should be double clickable" do
+    Selenium::WebDriver::Mouse.should_receive(:new).and_return(@selenium_driver)
+    @selenium_driver.should_receive(:double_click)
+    @selenium_element.double_click
+  end
+  
+  it "should be right clickable" do
+    @selenium_driver.should_receive(:context_click)
+    @selenium_element.right_click
+  end
+
+  it "should be able to block until it is present" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    @selenium_element.when_present(10)
+  end
+  
+  it "should return the element when it is present" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    element = @selenium_element.when_present(10)
+    element.should === @selenium_element
+  end
+
+  it "should return when an element is not present" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    @selenium_element.when_not_present
+  end
+
+  it "should be able to block until it is visible" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    @selenium_element.when_visible(10)
+  end
+  
+  it "should return the element when it is visible" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    element = @selenium_element.when_visible(10)
+    element.should === @selenium_element
+  end
+
+  it "should be able to block until it is not visible" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    @selenium_element.when_not_visible(10)
+  end
+
+  it "should return the element when it is not visible" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    element = @selenium_element.when_not_visible(10)
+    element.should === @selenium_element
+  end
+
+  it "should be able to block until a user define event fires true" do
+    wait = double('wait')
+    ::Selenium::WebDriver::Wait.should_receive(:new).and_return(wait)
+    wait.should_receive(:until)
+    @selenium_element.wait_until(10, "Element blah") {}
+  end
+
+  it "should send keys to the element" do
+    @selenium_driver.should_receive(:send_keys).with([:control, 'a'])
+    @selenium_element.send_keys([:control, 'a'])
+  end
+  
+  it "should clear its' contents" do
+    @selenium_driver.should_receive(:clear)
+    @selenium_element.clear
+  end
+
+  it "should fire an event" do
+    @selenium_driver.should_receive(:instance_variable_get).with(:@bridge).and_return(@selenium_driver)
+    @selenium_driver.should_receive(:executeScript)
+    @selenium_element.fire_event('onfocus')
+  end
+
+  it "should find the parent element" do
+    @selenium_driver.should_receive(:instance_variable_get).with(:@bridge).and_return(@selenium_driver)
+    @selenium_driver.should_receive(:executeScript).and_return(@selenium_driver)
+    @selenium_driver.should_receive(:tag_name).twice.and_return(:div)
+    @selenium_element.parent
+  end
+
+  it "should set the focus" do
+    @selenium_driver.should_receive(:instance_variable_get).and_return(@selenium_driver)
+    @selenium_driver.should_receive(:executeScript)
+    @selenium_element.focus
+  end
+
+  it "should scroll into view" do
+    @selenium_driver.should_receive(:location_once_scrolled_into_view)
+    @selenium_element.scroll_into_view
+  end
+end

data/spec/page-object/elements/span_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::Span do
+  let(:span) { PageObject::Elements::Span }
+
+  describe "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :text, :title, :xpath].each do |t|
+        identifier = span.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+
+    it "should map selenium types to same" do
+      [:class, :id, :index, :name, :text, :title, :xpath].each do |t|
+        key, value = span.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  it "should register with tag_name :span" do
+    ::PageObject::Elements.element_class_for(:span).should == ::PageObject::Elements::Span
+  end
+end

data/spec/page-object/elements/table_cell_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::TableCell do
+
+  context "interface" do
+    it "should register with tag_name :td" do
+      ::PageObject::Elements.element_class_for(:td).should == ::PageObject::Elements::TableCell
+    end
+
+    it "should register with tag_name :th" do
+      ::PageObject::Elements.element_class_for(:th).should == ::PageObject::Elements::TableCell
+    end
+
+    it "should always be enabled" do
+      table_cell_element = double('table_cell_element')
+      table_cell = PageObject::Elements::TableCell.new(table_cell_element, :platform => :selenium_webdriver)
+      table_cell.enabled?.should be true
+    end
+  end
+end

data/spec/page-object/elements/table_row_spec.rb

@@ -0,0 +1,70 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::TableRow do
+  let(:table_cell) { double('table_cell') }
+  let(:table_row_driver) { double('table_row_driver') }
+
+  describe "interface" do
+
+    it "should register with tag_name :tr" do
+      ::PageObject::Elements.element_class_for(:tr).should == ::PageObject::Elements::TableRow
+    end
+    
+    context "for selenium" do
+      it "should return a table cell when indexed" do
+        table_row = PageObject::Elements::TableRow.new(table_row_driver, :platform => :selenium_webdriver)
+        table_row.stub(:columns).and_return(2)
+        table_row_driver.should_receive(:find_elements).with(:xpath, ".//child::td|th").and_return(table_cell)
+        table_cell.should_receive(:[]).and_return(table_cell)
+        table_row[0].should be_instance_of PageObject::Elements::TableCell
+      end
+
+      it "should retrun the number of columns" do
+        table_row = PageObject::Elements::TableRow.new(table_row_driver, :platform => :selenium_webdriver)
+        table_row_driver.should_receive(:find_elements).with(:xpath, ".//child::td|th").and_return(table_row_driver)
+        table_row_driver.should_receive(:size).and_return(3)
+        table_row.columns.should == 3
+      end
+
+      it "should iterate over the table columns" do
+        table_row = PageObject::Elements::TableRow.new(table_row_driver, :platform => :selenium_webdriver)
+        table_row.should_receive(:columns).and_return(2)
+        table_row.stub(:[]).and_return(table_row_driver)
+        count = 0
+        table_row.each { |e| count += 1 }
+        count.should == 2
+      end
+    end
+
+    context "for watir" do
+      before(:each) do
+        table_row_driver.stub(:find_elements).and_return(table_row_driver)
+      end
+
+      it "should return a table cell when indexed" do
+        table_row = PageObject::Elements::TableRow.new(table_row_driver, :platform => :watir_webdriver)
+        table_row.stub(:columns).and_return(2)
+        table_row_driver.should_receive(:[]).with(1).and_return(table_cell)
+        table_row[1].should be_instance_of PageObject::Elements::TableCell
+      end
+
+      it "should return the number of columns" do
+        table_row = PageObject::Elements::TableRow.new(table_row_driver, :platform => :watir_webdriver)
+        table_row_driver.stub(:wd).and_return(table_row_driver)
+        table_row_driver.should_receive(:find_elements).with(:xpath, ".//child::td|th").and_return(table_row_driver)
+        table_row_driver.should_receive(:size).and_return(3)
+        table_row.columns.should == 3
+      end
+
+      it "should iterate over the table columns" do
+        table_row = PageObject::Elements::TableRow.new(table_row_driver, :platform => :watir_webdriver)
+        table_row.should_receive(:columns).and_return(2)
+        table_row.stub(:[])
+        count = 0
+        table_row.each { |e| count += 1 }
+        count.should == 2
+      end
+    end
+  end
+end

data/spec/page-object/elements/table_spec.rb

@@ -0,0 +1,98 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::Table do
+  describe "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :xpath].each do |t|
+        identifier = PageObject::Elements::Table.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+
+    it "should map selenium types to same" do
+      [:class, :id, :index, :name, :xpath].each do |t|
+        key, value = PageObject::Elements::Table.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  describe "interface" do
+    let(:table_element) { double('table_element') }
+
+    before(:each) do
+      table_element.stub(:[]).and_return(table_element)
+      table_element.stub(:find_elements).and_return(table_element)
+    end
+
+    it "should register with tag_name :table" do
+      ::PageObject::Elements.element_class_for(:table).should == ::PageObject::Elements::Table
+    end
+
+    context "for watir" do
+      let(:watir_table) { PageObject::Elements::Table.new(table_element, :platform => :watir_webdriver) }
+      
+      it "should return a table row when indexed" do
+        table_element.stub(:[]).with(1).and_return(table_element)
+        watir_table[1].should be_instance_of PageObject::Elements::TableRow
+      end
+
+      it "should return the first row" do
+        table_element.stub(:[]).with(0).and_return(table_element)
+        watir_table.first_row.should be_instance_of PageObject::Elements::TableRow
+      end
+
+      it "shoudl return the last row" do
+        table_element.stub(:[]).with(-1).and_return(table_element)
+        watir_table.last_row.should be_instance_of PageObject::Elements::TableRow
+      end
+
+      it "should return the number of rows" do
+        table_element.stub(:wd).and_return(table_element)
+        table_element.should_receive(:find_elements).with(:xpath, ".//child::tr").and_return(table_element)
+        table_element.should_receive(:size).and_return(2)
+        watir_table.rows.should == 2
+      end
+
+      it "should iterate over the table rows" do
+        watir_table.should_receive(:rows).and_return(2)
+        count = 0
+        watir_table.each { |e| count += 1 }
+        count.should == 2
+      end
+    end
+
+    context "for selenium" do
+      let(:selenium_table) { PageObject::Elements::Table.new(table_element, :platform => :selenium_webdriver) }
+      
+      it "should return a table row when indexed" do
+        table_element.should_receive(:find_elements).with(:xpath, ".//child::tr").and_return(table_element)
+        selenium_table[1].should be_instance_of PageObject::Elements::TableRow
+      end
+
+      it "should return the first row" do
+        table_element.stub(:[]).with(0).and_return(table_element)
+        selenium_table.first_row.should be_instance_of PageObject::Elements::TableRow
+      end
+
+      it "shoudl return the last row" do
+        table_element.stub(:[]).with(-1).and_return(table_element)
+        selenium_table.last_row.should be_instance_of PageObject::Elements::TableRow
+      end
+
+      it "should return the number of rows" do
+        table_element.should_receive(:find_elements).with(:xpath, ".//child::tr").and_return(table_element)
+        table_element.should_receive(:size).and_return(2)
+        selenium_table.rows.should == 2
+      end
+
+      it "should iterate over the table rows" do
+        selenium_table.should_receive(:rows).and_return(2)
+        count = 0
+        selenium_table.each { |e| count += 1 }
+        count.should == 2
+      end
+    end
+  end
+end

data/spec/page-object/elements/text_area_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::TextArea do
+  let(:textarea) { PageObject::Elements::TextArea }
+
+  describe "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :name, :xpath].each do |t|
+        identifier = textarea.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+
+    it "should map selenium types to same" do
+      [:class, :id, :name, :xpath, :index].each do |t|
+        key, value = textarea.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+  
+  describe "interface" do
+
+    it "should register with tag_name :textarea" do
+      ::PageObject::Elements.element_class_for(:textarea).should == ::PageObject::Elements::TextArea
+    end
+    
+    context "for Selenium" do
+      it "should set its' value" do
+        text_area_element = double('text_area')
+        text_area = PageObject::Elements::TextArea.new(text_area_element, :platform => :selenium_webdriver)
+        text_area_element.should_receive(:clear)
+        text_area_element.should_receive(:send_keys).with('Joseph')
+        text_area.value = 'Joseph'
+      end
+    end
+  end
+end

data/spec/page-object/elements/unordered_list_spec.rb

@@ -0,0 +1,95 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::UnorderedList do
+  let(:ul) { PageObject::Elements::UnorderedList }
+
+  describe "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :xpath].each do |t|
+        identifier = ul.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+
+    it "should map selenium types to same" do
+      [:class, :id, :index, :name, :xpath].each do |t|
+        key, value = ul.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  describe "interface" do
+    let(:ul_element) { double('ul_element') }
+
+    it "should register with tag_name :ul" do
+      ::PageObject::Elements.element_class_for(:ul).should == ::PageObject::Elements::UnorderedList
+    end
+
+    context "for watir" do
+      it "should return a list item when indexed" do
+        ul = PageObject::Elements::UnorderedList.new(ul_element, :platform => :watir_webdriver)
+        ul_element.stub(:uls).and_return([ul_element])
+        ul_element.stub(:find_elements).and_return(ul_element)
+        ul_element.stub(:map).and_return([ul_element])
+        ul_element.stub(:parent).and_return(ul_element)
+        ul_element.stub(:element).and_return(ul_element)
+        ul_element.stub(:==).and_return(true)
+        ul[1]
+      end
+
+      it "should know how many items it contains" do
+        ul = PageObject::Elements::UnorderedList.new(ul_element, :platform => :watir_webdriver)
+        ul_element.stub(:uls).and_return([ul_element])
+        ul_element.stub(:find_elements).and_return(ul_element)
+        ul_element.stub(:map).and_return([ul_element])
+        ul_element.stub(:parent).and_return(ul_element)
+        ul_element.stub(:element).and_return(ul_element)
+        ul_element.stub(:==).and_return(true)
+        ul.items.should == 1
+      end
+
+      it "should know how to iterate over the items" do
+        ul = PageObject::Elements::UnorderedList.new(ul_element, :platform => :watir_webdriver)
+        ul.should_receive(:items).and_return(5)
+        ul.stub(:[])
+        count = 0
+        ul.each { |item| count += 1 }
+        count.should == 5
+      end
+    end
+
+    context "for selenium" do
+      it "should return a list item when indexed" do
+        ul = PageObject::Elements::UnorderedList.new(ul_element, :platform => :selenium_webdriver)
+        ul_element.should_receive(:find_elements).and_return(ul_element)
+        ul_element.should_receive(:map).and_return([ul_element])
+        ul_element.should_receive(:parent).and_return(ul_element)
+        ul_element.should_receive(:element).and_return(ul_element)
+        ul_element.should_receive(:==).and_return(true)
+        ul[1]
+      end
+
+      it "should know how many items it contains" do
+        ul = PageObject::Elements::UnorderedList.new(ul_element, :platform => :selenium_webdriver)
+        ul_element.should_receive(:find_elements).and_return(ul_element)
+        ul_element.should_receive(:map).and_return([ul_element])
+        ul_element.should_receive(:parent).and_return(ul_element)
+        ul_element.should_receive(:element).and_return(ul_element)
+        ul_element.should_receive(:==).and_return(true)
+        ul.items.should == 1
+      end
+
+      it "should know how to iterate over the items" do
+        ul = PageObject::Elements::UnorderedList.new(ul_element, :platform => :selenium_webdriver)
+        ul.should_receive(:items).and_return(5)
+        ul.stub(:[])
+        count = 0
+        ul.each { |item| count += 1 }
+        count.should == 5
+
+      end
+    end
+  end
+end

data/spec/page-object/elements/watir_element_spec.rb

@@ -0,0 +1,142 @@
+require 'spec_helper'
+require 'page-object/elements/element'
+
+describe "Element for Watir" do
+  let(:watir_driver) { double('watir_driver') }
+  let(:watir_element) { ::PageObject::Elements::Element.new(watir_driver, :platform => :watir_webdriver) }
+
+  before(:each) do
+    Selenium::WebDriver::Mouse.stub(:new).and_return(watir_driver)
+  end
+
+  it "should know when it is visible" do
+    watir_driver.stub(:present?).and_return(true)
+    watir_driver.stub(:displayed?).and_return(true)
+    watir_element.visible?.should == true
+  end
+
+  it "should know when it is not visible" do
+    watir_driver.stub(:present?).and_return(false)
+    watir_driver.stub(:displayed?).and_return(false)
+    watir_element.visible?.should == false
+  end
+
+  it "should know when it exists" do
+    watir_driver.stub(:exists?).and_return(true)
+    watir_element.exists?.should == true
+  end
+
+  it "should know when it does not exist" do
+    watir_driver.stub(:exists?).and_return(false)
+    watir_driver.stub(:nil?).and_return(true)
+    watir_element.exists?.should == false
+  end
+
+  it "should be able to return the text contained in the element" do
+    watir_driver.should_receive(:text).and_return("my text")
+    watir_element.text.should == "my text"
+  end
+
+  it "should know when it is equal to another" do
+    watir_driver.should_receive(:==).and_return(true)
+    watir_element.should == watir_element
+  end
+
+  it "should return its tag name" do
+    watir_driver.should_receive(:tag_name).and_return("h1")
+    watir_element.tag_name.should == "h1"
+  end
+
+  it "should know its value" do
+    watir_driver.stub(:value).and_return("value")
+    watir_driver.stub(:attribute).and_return("value")
+    watir_element.value.should == "value"
+  end
+
+  it "should know how to retrieve the value of an attribute" do
+    watir_driver.stub(:attribute_value).and_return(true)
+    watir_driver.stub(:attribute).and_return(true)
+    watir_element.attribute("readonly").should be true
+  end
+
+  it "should be clickable" do
+    watir_driver.should_receive(:click)
+    watir_element.click
+  end
+  
+  it "should be double clickable" do
+    
+    watir_driver.should_receive(:double_click)
+    watir_element.double_click
+  end
+  
+  it "should be right clickable" do
+    watir_driver.stub(:right_click)
+    watir_driver.stub(:context_click)
+    watir_element.right_click
+  end
+
+  it "should be able to block until it is present" do
+    watir_driver.stub(:wait_until_present).with(10)
+    watir_element.when_present(10)
+  end
+  
+  it "should return the element when it is present" do
+    watir_driver.stub(:wait_until_present).with(10)
+    element = watir_element.when_present(10)
+    element.should === watir_element
+  end
+
+  it "should use the overriden wait when set" do
+    PageObject.default_element_wait = 20
+    watir_driver.stub(:wait_until_present).with(20)
+    watir_element.when_present
+  end
+
+  it "should be able to block until it is visible" do
+    ::Watir::Wait.stub(:until).with(10, "Element was not visible in 10 seconds")
+    watir_driver.stub(:displayed?).and_return(true)
+    watir_element.when_visible(10)
+  end
+  
+  it "should return the element when it is visible" do
+    ::Watir::Wait.stub(:until).with(10, "Element was not visible in 10 seconds")
+    watir_driver.stub(:displayed?).and_return(true)
+    element = watir_element.when_visible(10)
+    element.should === watir_element
+  end
+
+  it "should be able to block until it is not visible" do
+    ::Watir::Wait.stub(:while).with(10, "Element still visible after 10 seconds")
+    watir_driver.stub(:displayed?).and_return(false)
+    watir_element.when_not_visible(10)
+  end
+  
+  it "should return the element when it is not visible" do
+    ::Watir::Wait.stub(:while).with(10, "Element still visible after 10 seconds")
+    watir_driver.stub(:displayed?).and_return(false)
+    element = watir_element.when_not_visible(10)
+    element.should === watir_element
+  end
+
+  it "should be able to block until a user define event fires true" do
+    ::Watir::Wait.stub(:until).with(10, "Element blah")
+    watir_element.wait_until(10, "Element blah") {true}
+  end
+  
+  it "should send keys to the element" do
+    watir_driver.should_receive(:send_keys).with([:control, 'a'])
+    watir_element.send_keys([:control, 'a'])
+  end
+  
+  it "should clear its' contents" do
+    watir_driver.should_receive(:clear)
+    watir_element.clear
+  end
+
+  it "should scroll into view" do
+    watir_driver.stub(:wd).and_return(watir_driver)
+    watir_driver.should_receive(:location_once_scrolled_into_view)
+    watir_element.scroll_into_view
+  end
+end