page_object 1.1.1

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
+      expect(::PageObject::Elements.element_class_for(:option)).to eql ::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'
+        expect(identifier.keys.first).to eql 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'
+        expect(key).to eql t
+      end
+    end
+  end
+
+  describe "interface" do
+    let(:ol_element) { double('ol_element') }
+
+    it "should register as tag_name :ol" do
+      expect(::PageObject::Elements.element_class_for(:ol)).to eql ::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)
+        allow(ol_element).to receive(:ols).and_return([ol_element])
+        allow(ol_element).to receive(:find_elements).and_return(ol_element)
+        allow(ol_element).to receive(:map).and_return([ol_element])
+        allow(ol_element).to receive(:parent).and_return(ol_element)
+        allow(ol_element).to receive(:element).and_return(ol_element)
+        allow(ol_element).to 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 => :watir_webdriver)
+        allow(ol_element).to receive(:ols).and_return([ol_element])
+        allow(ol_element).to receive(:find_elements).and_return(ol_element)
+        allow(ol_element).to receive(:map).and_return([ol_element])
+        allow(ol_element).to receive(:parent).and_return(ol_element)
+        allow(ol_element).to receive(:element).and_return(ol_element)
+        allow(ol_element).to receive(:==).and_return(true)
+        expect(ol.items).to eql 1
+      end
+
+      it "should iterate over the list items" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :watir_webdriver)
+        expect(ol).to receive(:items).and_return(5)
+        allow(ol).to receive(:[])
+        count = 0
+        ol.each { |item| count += 1 }
+        expect(count).to eql 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)
+        expect(ol_element).to receive(:find_elements).and_return(ol_element)
+        expect(ol_element).to receive(:map).and_return([ol_element])
+        expect(ol_element).to receive(:parent).and_return(ol_element)
+        expect(ol_element).to receive(:element).and_return(ol_element)
+        expect(ol_element).to 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)
+        expect(ol_element).to receive(:find_elements).and_return(ol_element)
+        expect(ol_element).to receive(:map).and_return([ol_element])
+        expect(ol_element).to receive(:parent).and_return(ol_element)
+        expect(ol_element).to receive(:element).and_return(ol_element)
+        expect(ol_element).to receive(:==).and_return(true)
+        expect(ol.items).to eql 1
+      end
+
+      it "should iterate over the list items" do
+        ol = PageObject::Elements::OrderedList.new(ol_element, :platform => :selenium_webdriver)
+        expect(ol).to receive(:items).and_return(5)
+        allow(ol).to receive(:[])
+        count = 0
+        ol.each { |item| count += 1 }
+        expect(count).to eql 5
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+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'
+        expect(identifier.keys.first).to eql 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'
+        expect(key).to eql t
+      end
+    end
+  end
+  
+  describe "interface" do
+    it "should register with type :checkbox" do
+      expect(::PageObject::Elements.element_class_for(:p)).to eql ::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'
+        expect(identifier.keys.first).to eql 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'
+        expect(key).to eql t
+      end
+    end
+  end
+
+  describe "interface" do
+    let(:sel_list) { double('select_list') }
+    let(:opts) { [sel_list, sel_list] }
+
+    before(:each) do
+      allow(sel_list).to receive(:find_elements).and_return(sel_list)
+      allow(sel_list).to receive(:each)
+      allow(sel_list).to receive(:wd).and_return(sel_list)
+      allow(sel_list).to receive(:map).and_return(opts)
+      allow(sel_list).to receive(:any?)
+      allow(sel_list).to receive(:include?)
+      allow(sel_list).to receive(:select).and_return(opts)
+      allow(sel_list).to receive(:text).and_return('blah')
+    end
+
+    it "should register with tag_name :select" do
+      expect(::PageObject::Elements.element_class_for(:select)).to eql ::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
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        expect(watir_sel_list[0]).to be_instance_of PageObject::Elements::Option
+      end
+
+      it "should return an array of options" do
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        expect(watir_sel_list.options.size).to eql 2
+      end
+
+      it "should return an array of selected options" do
+        allow(sel_list).to receive(:selected_options).and_return(opts)
+        allow(sel_list).to receive(:text).and_return(sel_list)
+        expect(watir_sel_list.selected_options).to eql opts
+      end
+
+      it "should know if it includes some value" do
+        allow(sel_list).to receive(:include?).with('blah').and_return(true)
+        watir_sel_list.include?('blah')
+      end
+
+      it "should know if an option is selected" do
+        allow(sel_list).to receive(: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
+        allow(sel_list).to receive(:selected_options).and_return(opts)
+        allow(sel_list).to receive(:value).and_return(sel_list)
+        expect(watir_sel_list.selected_values).to eql 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
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        expect(selenium_sel_list[1]).to be_instance_of PageObject::Elements::Option
+      end
+
+      it "should return an array of options" do
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        expect(selenium_sel_list.options.size).to eql 2
+      end
+
+      it "should select an element" do
+        option = double('option')
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return([option])
+        expect(option).to receive(:text).and_return('something')
+        expect(option).to receive(:click)
+        selenium_sel_list.select 'something'
+      end
+
+      it "should return an array of selected options" do
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        expect(opts[0]).to receive(:selected?).and_return(true)
+        expect(opts[0]).to receive(:text).and_return('test1')
+        expect(opts[1]).to receive(:selected?).and_return(false)
+        selected = selenium_sel_list.selected_options
+        expect(selected.size).to eql 1
+        expect(selected[0]).to eql 'test1'
+      end
+
+      it "should return an array of selected options" do
+        expect(sel_list).to receive(:find_elements).with(:xpath, ".//child::option").and_return(opts)
+        expect(opts[0]).to receive(:selected?).and_return(true)
+        expect(opts[0]).to receive(:attribute).and_return('test1')
+        expect(opts[1]).to receive(:selected?).and_return(false)
+        selected = selenium_sel_list.selected_values
+        expect(selected.size).to eql 1
+        expect(selected[0]).to eql 'test1'
+      end
+
+      it "should know if it includes some value" do
+        expect(sel_list).to receive(:find_elements).and_return(opts)
+        expect(opts[0]).to receive(:text).and_return('blah')
+        expect(selenium_sel_list).to include 'blah'
+      end
+
+      it "should know if an option is selected" do
+        expect(sel_list).to receive(:find_elements).and_return(opts)
+        expect(opts[0]).to receive(:selected?).twice.and_return(true)
+        expect(opts[0]).to receive(:text).and_return('blah')
+        expect(selenium_sel_list.selected?('blah')).to be true
+      end
+
+      it "should be able to clear selected options" do
+        expect(sel_list).to receive(:find_elements).and_return(opts)
+        opts.each do |opt|
+          expect(opt).to receive(:selected?).and_return(true)
+          expect(opt).to 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'
+        expect(identifier.keys.first).to eql 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'
+        expect(key).to eql t
+      end
+    end
+  end
+
+  describe "interface" do
+
+    it "should register as type :radio" do
+      expect(::PageObject::Elements.element_class_for(:input, :radio)).to eql ::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
+        expect(selenium_rb).to receive(:click)
+        expect(selenium_rb).to receive(:selected?).and_return(false)
+        radio_button.select
+      end
+      
+      it "should know if it is selected" do
+        expect(selenium_rb).to receive(:selected?).and_return(true)
+        expect(radio_button).to 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'
+        expect(identifier.keys.first).to eql 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'
+        expect(key).to eql 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
+      expect(::PageObject::Elements.element_class_for(:input, :text)).to eql ::PageObject::Elements::TextField
+    end
+
+    it "should register with type :password" do
+      expect(::PageObject::Elements.element_class_for(:input, :password)).to eql ::PageObject::Elements::TextField
+    end
+
+    it "should append text" do
+      expect(text_field_element).to receive(:send_keys).with('abc')
+      selenium_text_field.append('abc')
+    end
+    
+    context "for selenium" do
+      it "should set its' value" do
+        expect(text_field_element).to receive(:clear)
+        expect(text_field_element).to receive(:send_keys).with('Joseph')
+        selenium_text_field.value = 'Joseph'
+      end
+    end
+  end
+end

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

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