meeane-page-object 0.1.8

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

@@ -0,0 +1,254 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+
+describe "Element with nested elements" do
+  context "in Watir" do
+    before(:each) do
+      @watir_driver = Watir::Element.new(nil, {})
+      @watir_element = PageObject::Elements::Element.new(@watir_driver, :platform => :watir_webdriver)
+    end
+    
+    it "should find nested links" do
+      @watir_driver.should_receive(:link).with(:id => 'blah').and_return(@watir_driver)
+      @watir_element.link_element(:id => 'blah')
+    end
+
+    it "should find nested buttons" do
+      @watir_driver.should_receive(:button).with(:id => 'blah').and_return(@watir_driver)
+      @watir_element.button_element(:id => 'blah')
+    end
+    
+    it "should find nested text fields" do
+      @watir_driver.should_receive(:text_field).with(:id => 'blah').and_return(@watir_driver)
+      @watir_element.text_field_element(:id => 'blah')
+    end
+
+    it "should find nested hidden fields" do
+      @watir_driver.should_receive(:hidden).and_return(@watir_driver)
+      @watir_element.hidden_field_element
+    end
+
+    it "should find nested text areas" do
+      @watir_driver.should_receive(:textarea).and_return(@watir_driver)
+      @watir_element.text_area_element
+    end
+
+    it "should find a nested select list" do
+      @watir_driver.should_receive(:select_list).and_return(@watir_driver)
+      @watir_element.select_list_element
+    end
+
+    it "should find a nested checkbox" do
+      @watir_driver.should_receive(:checkbox).and_return(@watir_driver)
+      @watir_element.checkbox_element
+    end
+    
+    it "should find a nested radio button" do
+      @watir_driver.should_receive(:radio).and_return(@watir_driver)
+      @watir_element.radio_button_element
+    end
+    
+    it "should find a nested div" do
+      @watir_driver.should_receive(:div).and_return(@watir_driver)
+      @watir_element.div_element
+    end
+    
+    it "should find a nested span" do
+      @watir_driver.should_receive(:span).and_return(@watir_driver)
+      @watir_element.span_element
+    end
+    
+    it "should find a nested table" do
+      @watir_driver.should_receive(:table).and_return(@watir_driver)
+      @watir_element.table_element
+    end
+
+    it "should find a nested cell" do
+      @watir_driver.should_receive(:td).and_return(@watir_driver)
+      @watir_element.cell_element
+    end
+    
+    it "should find a nested image" do
+      @watir_driver.should_receive(:image).and_return(@watir_driver)
+      @watir_element.image_element
+    end
+    
+    it "should find a nested form" do
+      @watir_driver.should_receive(:form).and_return(@watir_driver)
+      @watir_element.form_element
+    end
+    
+    it "should find a nested ordered list" do
+      @watir_driver.should_receive(:ol).and_return(@watir_driver)
+      @watir_element.ordered_list_element
+    end
+    
+    it "should find a nested unordered list" do
+      @watir_driver.should_receive(:ul).and_return(@watir_driver)
+      @watir_element.unordered_list_element
+    end
+    
+    it "should find a nested list item" do
+      @watir_driver.should_receive(:li).and_return(@watir_driver)
+      @watir_element.list_item_element
+    end
+    
+    it "should find a nested h1" do
+      @watir_driver.should_receive(:h1).and_return(@watir_driver)
+      @watir_element.h1_element
+    end
+
+    it "should find a nested h2" do
+      @watir_driver.should_receive(:h2).and_return(@watir_driver)
+      @watir_element.h2_element
+    end
+
+    it "should find a nested h3" do
+      @watir_driver.should_receive(:h3).and_return(@watir_driver)
+      @watir_element.h3_element
+    end
+
+    it "should find a nested h4" do
+      @watir_driver.should_receive(:h4).and_return(@watir_driver)
+      @watir_element.h4_element
+    end
+
+    it "should find a nested h5" do
+      @watir_driver.should_receive(:h5).and_return(@watir_driver)
+      @watir_element.h5_element
+    end
+
+    it "should find a nested h6" do
+      @watir_driver.should_receive(:h6).and_return(@watir_driver)
+      @watir_element.h6_element
+    end
+  end
+  
+  context "in Selenium" do
+    before(:each) do
+      @selenium_driver = double('selenium')
+      @selenium_element = PageObject::Elements::Element.new(@selenium_driver, :platform => :selenium_webdriver)
+    end
+
+    it "should find nested links" do
+      @selenium_driver.should_receive(:find_element).with(:id, 'blah').and_return(@selenium_driver)
+      @selenium_element.link_element(:id => 'blah')
+    end
+
+    it "should find nested buttons" do
+      @selenium_driver.should_receive(:find_element).with(:id, 'blah').and_return(@selenium_driver)
+      @selenium_element.button_element(:id => 'blah')
+    end
+    
+    it "should find nested text fields" do
+      @selenium_driver.should_receive(:find_element).with(:id, 'blah').and_return(@selenium_driver)
+      @selenium_element.text_field_element(:id => 'blah')
+    end
+    
+    it "should find nested hidden fields" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.hidden_field_element
+    end
+    
+    it "should find nested text areas" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.text_area_element
+    end
+    
+    it "should find a nested select list" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.select_list_element
+    end
+    
+    it "should find a nested checkbox" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.checkbox_element
+    end
+    
+    it "should find a nested radio button" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.radio_button_element
+    end
+    
+    it "should find a nested div" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.div_element
+    end
+    
+    it "should find a nested span" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.span_element
+    end
+    
+    it "should find a nested table" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.table_element
+    end
+
+    it "should find a nested cell" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.cell_element
+    end
+    
+    it "should find a nested image" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.image_element
+    end
+    
+    it "should find a nested form" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.form_element
+    end
+    
+    it "should find an ordered list" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.ordered_list_element
+    end
+    
+    it "should find an unordered list" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.unordered_list_element
+    end
+    
+    it "should find a nested list item" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.list_item_element
+    end
+    
+    it "should find a nested h1" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.h1_element
+    end
+    
+    it "should find a nested h2" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.h2_element
+    end
+
+    it "should find a nested h3" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.h3_element
+    end
+
+    it "should find a nested h4" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.h4_element
+    end
+
+    it "should find a nested h5" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.h5_element
+    end
+
+    it "should find a nested h6" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.h6_element
+    end
+
+    it "should find a nested paragraph" do
+      @selenium_driver.should_receive(:find_element).and_return(@selenium_driver)
+      @selenium_element.paragraph_element
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::Option do
+
+  describe "interface" do
+    it "should register as tag_name :option" do
+      ::PageObject::Elements.element_class_for(:option).should == ::PageObject::Elements::Option
+    end
+  end
+end

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

@@ -0,0 +1,94 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::OrderedList do
+  let(:ol) { PageObject::Elements::OrderedList }
+
+  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 = ol.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 = ol.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  describe "interface" do
+    let(:ol_element) { double('ol_element') }
+
+    it "should register as tag_name :ol" do
+      ::PageObject::Elements.element_class_for(:ol).should == ::PageObject::Elements::OrderedList
+    end
+
+    context "for watir" do
+      it "should return a list item when indexed" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :watir_webdriver)
+        ol_element.stub(:ols).and_return([ol_element])
+        ol_element.stub(:find_elements).and_return(ol_element)
+        ol_element.stub(:map).and_return([ol_element])
+        ol_element.stub(:parent).and_return(ol_element)
+        ol_element.stub(:element).and_return(ol_element)
+        ol_element.stub(:==).and_return(true)
+        ol[1]
+      end
+
+      it "should know how many list items it contains" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :watir_webdriver)
+        ol_element.stub(:ols).and_return([ol_element])
+        ol_element.stub(:find_elements).and_return(ol_element)
+        ol_element.stub(:map).and_return([ol_element])
+        ol_element.stub(:parent).and_return(ol_element)
+        ol_element.stub(:element).and_return(ol_element)
+        ol_element.stub(:==).and_return(true)
+        ol.items.should == 1
+      end
+
+      it "should iterate over the list items" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :watir_webdriver)
+        ol.should_receive(:items).and_return(5)
+        ol.stub(:[])
+        count = 0
+        ol.each { |item| count += 1 }
+        count.should == 5
+      end
+    end
+
+    context "for selenium" do
+      it "should return a list item when indexed" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :selenium_webdriver)
+        ol_element.should_receive(:find_elements).and_return(ol_element)
+        ol_element.should_receive(:map).and_return([ol_element])
+        ol_element.should_receive(:parent).and_return(ol_element)
+        ol_element.should_receive(:element).and_return(ol_element)
+        ol_element.should_receive(:==).and_return(true)
+        ol[1]
+      end
+
+      it "should know how many list items it contains" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :selenium_webdriver)
+        ol_element.should_receive(:find_elements).and_return(ol_element)
+        ol_element.should_receive(:map).and_return([ol_element])
+        ol_element.should_receive(:parent).and_return(ol_element)
+        ol_element.should_receive(:element).and_return(ol_element)
+        ol_element.should_receive(:==).and_return(true)
+        ol.items.should == 1
+      end
+
+      it "should iterate over the list items" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :selenium_webdriver)
+        ol.should_receive(:items).and_return(5)
+        ol.stub(:[])
+        count = 0
+        ol.each { |item| count += 1 }
+        count.should == 5
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::Paragraph do
+  let(:paragraph) { PageObject::Elements::Paragraph }
+
+  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 = paragraph.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 = paragraph.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+  
+  describe "interface" do
+
+    it "should register with type :checkbox" do
+      ::PageObject::Elements.element_class_for(:p).should == ::PageObject::Elements::Paragraph
+    end
+  end
+end

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

@@ -0,0 +1,142 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::SelectList do
+  let(:selectlist) { PageObject::Elements::SelectList }
+
+  describe "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :name, :text, :value, :xpath].each do |t|
+        identifier = selectlist.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 = selectlist.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  describe "interface" do
+    let(:sel_list) { double('select_list') }
+    let(:opts) { [sel_list, sel_list] }
+
+    before(:each) do
+      sel_list.stub(:find_elements).and_return(sel_list)
+      sel_list.stub(:each)
+      sel_list.stub(:wd).and_return(sel_list)
+      sel_list.stub(:map).and_return(opts)
+      sel_list.stub(:any?)
+      sel_list.stub(:include?)
+      sel_list.stub(:select).and_return(opts)
+      sel_list.stub(:text).and_return('blah')
+    end
+
+    it "should register with tag_name :select" do
+      ::PageObject::Elements.element_class_for(:select).should == ::PageObject::Elements::SelectList
+    end
+
+    context "for watir" do
+      let(:watir_sel_list) { PageObject::Elements::SelectList.new(sel_list, :platform => :watir_webdriver) }
+
+      it "should return an option when indexed" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        watir_sel_list[0].should be_instance_of PageObject::Elements::Option
+      end
+
+      it "should return an array of options" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        watir_sel_list.options.size.should == 2
+      end
+
+      it "should return an array of selected options" do
+        sel_list.stub(:selected_options).and_return(opts)
+        sel_list.stub(:text).and_return(sel_list)
+        watir_sel_list.selected_options.should == opts
+      end
+
+      it "should know if it includes some value" do
+        sel_list.stub(:include?).with('blah').and_return(true)
+        watir_sel_list.include?('blah')
+      end
+
+      it "should know if an option is selected" do
+        sel_list.stub(:selected?).with('blah').and_return(true)
+        watir_sel_list.selected?('blah')
+      end
+
+      it "should be able to get the value for the selected options" do
+        sel_list.stub(:selected_options).and_return(opts)
+        sel_list.stub(:value).and_return(sel_list)
+        watir_sel_list.selected_values.should == opts
+      end
+    end
+
+    context "for selenium"  do
+      let(:selenium_sel_list) { PageObject::Elements::SelectList.new(sel_list, :platform => :selenium_webdriver) }
+
+      it "should return an option when indexed" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        selenium_sel_list[1].should be_instance_of PageObject::Elements::Option
+      end
+
+      it "should return an array of options" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        selenium_sel_list.options.size.should == 2
+      end
+
+      it "should select an element" do
+        option = double('option')
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return([option])
+        option.should_receive(:text).and_return('something')
+        option.should_receive(:click)
+        selenium_sel_list.select 'something'
+      end
+
+      it "should return an array of selected options" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        opts[0].should_receive(:selected?).and_return(true)
+        opts[0].should_receive(:text).and_return('test1')
+        opts[1].should_receive(:selected?).and_return(false)
+        selected = selenium_sel_list.selected_options
+        selected.size.should == 1
+        selected[0].should == 'test1'
+      end
+
+      it "should return an array of selected options" do
+        sel_list.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        opts[0].should_receive(:selected?).and_return(true)
+        opts[0].should_receive(:attribute).and_return('test1')
+        opts[1].should_receive(:selected?).and_return(false)
+        selected = selenium_sel_list.selected_values
+        selected.size.should == 1
+        selected[0].should == 'test1'
+      end
+
+      it "should know if it includes some value" do
+        sel_list.should_receive(:find_elements).and_return(opts)
+        opts[0].should_receive(:text).and_return('blah')
+        selenium_sel_list.should include 'blah'
+      end
+
+      it "should know if an option is selected" do
+        sel_list.should_receive(:find_elements).and_return(opts)
+        opts[0].should_receive(:selected?).twice.and_return(true)
+        opts[0].should_receive(:text).and_return('blah')
+        selenium_sel_list.selected?('blah').should be true
+      end
+
+      it "should be able to clear selected options" do
+        sel_list.should_receive(:find_elements).and_return(opts)
+        opts.each do |opt|
+          opt.should_receive(:selected?).and_return(true)
+          opt.should_receive(:click)
+        end
+        selenium_sel_list.clear
+      end
+    end
+  end
+end

data/spec/page-object/elements/selenium/radio_button_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::RadioButton do
+  let(:radiobutton) { PageObject::Elements::RadioButton }
+
+  describe "when mapping how to find an element" do
+    it "should map watir types to same" do
+      [:class, :id, :index, :name, :value, :xpath].each do |t|
+        identifier = radiobutton.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+    it "should map selenium types to same" do
+      [:class, :id, :name, :xpath, :value, :index].each do |t|
+        key, value = radiobutton.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+
+  describe "interface" do
+
+    it "should register as type :radio" do
+      ::PageObject::Elements.element_class_for(:input, :radio).should == ::PageObject::Elements::RadioButton
+    end
+    
+    context "for selenium" do
+      let(:selenium_rb) { double('radio_button') }
+      let(:radio_button) { PageObject::Elements::RadioButton.new(selenium_rb, :platform => :selenium_webdriver) }
+
+      it "should select" do
+        selenium_rb.should_receive(:click)
+        selenium_rb.should_receive(:selected?).and_return(false)
+        radio_button.select
+      end
+      
+      it "should know if it is selected" do
+        selenium_rb.should_receive(:selected?).and_return(true)
+        radio_button.should be_selected
+      end
+    end
+  end
+end

data/spec/page-object/elements/selenium/text_field_spec.rb

@@ -0,0 +1,49 @@
+require 'spec_helper'
+require 'page-object/elements'
+
+describe PageObject::Elements::TextField do
+
+  describe "when mapping how to find an element" do
+    let(:textfield) { PageObject::Elements::TextField }
+
+    it "should map watir types to same" do
+      [:class, :id, :index, :name, :title, :xpath, :text, :label].each do |t|
+        identifier = textfield.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+
+    it "should map selenium types to same" do
+      [:class, :id, :name, :title, :xpath, :index, :text, :label].each do |t|
+        key, value = textfield.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+  
+  describe "interface" do
+    let(:text_field_element) { double('text_field') }
+    let(:selenium_text_field) { PageObject::Elements::TextField.new(text_field_element, :platform => :selenium_webdriver) }
+
+    it "should register with type :text" do
+      ::PageObject::Elements.element_class_for(:input, :text).should == ::PageObject::Elements::TextField
+    end
+
+    it "should register with type :password" do
+      ::PageObject::Elements.element_class_for(:input, :password).should == ::PageObject::Elements::TextField
+    end
+
+    it "should append text" do
+      text_field_element.should_receive(:send_keys).with('abc')
+      selenium_text_field.append('abc')
+    end
+    
+    context "for selenium" do
+      it "should set its' value" do
+        text_field_element.should_receive(:clear)
+        text_field_element.should_receive(:send_keys).with('Joseph')
+        selenium_text_field.value = 'Joseph'
+      end
+    end
+  end
+end