page_object 1.1.1

data/spec/page-object/javascript_framework_facade_spec.rb

@@ -0,0 +1,61 @@
+require 'spec_helper'
+
+class TestClass
+  include PageObject::JavascriptFrameworkFacade
+end
+
+
+describe PageObject::JavascriptFrameworkFacade do
+  let(:facade) { PageObject::JavascriptFrameworkFacade }
+  
+  it "should allow the selection of a javascript framework" do
+    facade.framework = :jquery
+    expect(facade.framework).to eql :jquery
+  end
+
+  it "should register the jQuery script builder" do
+    facade.framework = :jquery
+    expect(facade.script_builder).to eql ::PageObject::Javascript::JQuery
+  end
+
+  it "should return script for pending requests in jQuery" do
+    facade.framework = :jquery
+    expect(facade.pending_requests).to eql 'return jQuery.active'
+  end
+
+  it "should register the Prototype script builder" do
+    facade.framework = :prototype
+    expect(facade.script_builder).to eql ::PageObject::Javascript::Prototype
+  end
+
+  it "should return script for pending requests in Prototype" do
+    facade.framework = :prototype
+    expect(facade.pending_requests).to eql 'return Ajax.activeRequestCount'
+  end
+
+  it "should not allow you to set the framework to one it does not know about" do
+    expect{ facade.framework = :blah }.to raise_error
+  end
+
+  it "should allow you to add a new javascript framework" do
+    module GoodFake
+      def self.pending_requests
+        "fake"
+      end
+    end
+    
+    facade.add_framework(:blah, GoodFake)
+    facade.framework = :blah
+    expect(facade.pending_requests).to eql "fake"
+  end
+
+  it "should not allow you to add a new javascript framework that is invalid" do
+    module BadFake
+      def self.blah
+      end
+    end
+
+    expect{ facade.add_framework(:blah, BadFake) }.to raise_error
+  end
+end
+

data/spec/page-object/loads_platform_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+class TestLoadsPlatform
+  include PageObject::LoadsPlatform
+end
+describe TestLoadsPlatform do
+  let(:subject) { TestLoadsPlatform.new }
+  let(:adapters) { {} }
+
+  context "when browser x is registered with platform nom_nom_nom" do
+    let(:browser_x) { double('browser') }
+    before { adapters[:browser_x] = mock_adapter(browser_x, :nom_nom_nom) }
+
+    it "returns platform nom_nom_nom  when asked about browser_x" do
+      expect(subject.load_platform(browser_x, adapters)).to eql :nom_nom_nom
+    end
+    
+    context "when browser a is registered with platform boom_boom_boom" do
+      let(:browser_a) { double('browser') }
+      before { adapters[:browser_a] = mock_adapter(browser_a, :boom_boom_boom) }
+      
+      it "should return platform nom_nom_nom when asked about browser_x" do
+        expect(subject.load_platform(browser_x, adapters)).to eql :nom_nom_nom
+      end
+    end
+  end
+  
+  context "when browser a is registered with platform boom_boom_boom" do
+    let(:browser_n) { double('browser') }
+    before { adapters[:browser_n] = mock_adapter(browser_n, :boom_boom_boom) }
+
+    it "should return platform boom_boom_boom" do
+      expect(subject.load_platform(browser_n, adapters)).to eql :boom_boom_boom
+    end
+  end
+
+  context "When an unknow object is passed in" do
+    let(:basic_message) { 'Unable to pick a platform for the provided browser or element:' }
+    
+    it "should throw an exception" do
+      expect {
+        subject.load_platform("browser", {})
+      }.to raise_error("#{basic_message} \"browser\".")
+    end
+
+    it "should notify when the browser is nil" do
+      begin
+        subject.load_platform(nil, {})
+      rescue Exception => e
+        expect(e.message).to eql "#{basic_message} nil.\nnil was passed to the PageObject constructor instead of a valid browser or element object."
+      end
+    end
+  end
+end

data/spec/page-object/page-object_spec.rb

@@ -0,0 +1,407 @@
+require 'spec_helper'
+
+class PageObjectTestPageObject
+  include PageObject
+end
+
+class CustomPlatform
+end
+
+describe PageObject do
+  let(:watir_browser) { mock_watir_browser }
+  let(:selenium_browser) { mock_selenium_browser }
+  let(:watir_page_object) { PageObjectTestPageObject.new(watir_browser) }
+  let(:selenium_page_object) { PageObjectTestPageObject.new(selenium_browser) }
+
+  context "setting values on the PageObject module" do
+    it "should set the javascript framework" do
+      expect(PageObject::JavascriptFrameworkFacade).to receive(:framework=)
+      PageObject.javascript_framework = :foo
+    end
+
+    it "should add a new Javascript Framework" do
+      expect(PageObject::JavascriptFrameworkFacade).to receive(:add_framework)
+      PageObject.add_framework(:foo, :bar)
+    end
+
+    it "should set a default page wait value" do
+      PageObject.default_page_wait = 20
+      wait = PageObject.instance_variable_get("@page_wait")
+      expect(wait).to eql 20
+    end
+
+    it "should provide the default page wait value" do
+      PageObject.instance_variable_set("@page_wait", 10)
+      expect(PageObject.default_page_wait).to eql 10
+    end
+
+    it "should default the page wait value to 30" do
+      PageObject.instance_variable_set("@page_wait", nil)
+      expect(PageObject.default_page_wait).to eql 30
+    end
+
+    it "should set the default element wait value" do
+      PageObject.default_element_wait = 20
+      wait = PageObject.instance_variable_get("@element_wait")
+      expect(wait).to eql 20
+    end
+
+    it "should provide the default element wait value" do
+      PageObject.instance_variable_set("@element_wait", 10)
+      expect(PageObject.default_element_wait).to eql 10
+    end
+
+    it "should default the element wait to 5" do
+      PageObject.instance_variable_set("@element_wait", nil)
+      expect(PageObject.default_element_wait).to eql 5
+    end
+  end
+
+  context "setting values on the PageObject class instance" do
+    it "should set the params value" do
+      PageObjectTestPageObject.params = {:some => :value}
+      params = PageObjectTestPageObject.instance_variable_get("@params")
+      expect(params[:some]).to eql :value
+    end
+
+    it "should provide the params value" do
+      PageObjectTestPageObject.instance_variable_set("@params", {:value => :updated})
+      expect(PageObjectTestPageObject.params[:value]).to eql :updated
+    end
+
+    it "should default the params to an empty hash" do
+      PageObjectTestPageObject.instance_variable_set("@params", nil)
+      expect(PageObjectTestPageObject.params).to eql Hash.new
+    end
+  end
+
+  context "when created with a watir-webdriver browser" do
+    it "should include the WatirPageObject module" do
+      expect(watir_page_object.platform).to be_kind_of PageObject::Platforms::WatirWebDriver::PageObject
+    end
+  end
+
+  context "when created with a selenium browser" do
+    it "should include the SeleniumPageObject module" do
+      expect(selenium_page_object.platform).to be_kind_of PageObject::Platforms::SeleniumWebDriver::PageObject
+    end
+  end
+  
+  context "when created with a non_bundled adapter" do
+    let(:custom_adapter) { mock_adapter(:custom_browser, CustomPlatform) }
+    
+    it "should be an instance of whatever that objects adapter is" do
+      mock_adapters({:custom_adapter=>custom_adapter})
+      custom_page_object = PageObjectTestPageObject.new(:custom_browser)
+      expect(custom_page_object.platform).to be custom_adapter.create_page_object
+    end
+  end
+  
+  context "when created with an object we do not understand" do
+    it "should throw an error" do
+      expect {
+        TestPageObject.new("blah")
+      }.to raise_error
+    end
+  end
+
+  describe "page level functionality" do
+    context "for all drivers" do
+      it "should try a second time after sleeping when attach to window fails" do
+        expect(watir_page_object.platform).to receive(:attach_to_window).once.and_throw "error"
+        expect(watir_page_object.platform).to receive(:attach_to_window)
+        watir_page_object.attach_to_window("blah")
+      end
+      
+      it "should call initialize_page if it exists" do
+        class CallbackPage
+          include PageObject
+          attr_reader :initialize_page_called
+        
+          def initialize_page
+            @initialize_page_called = true
+          end
+        end
+        
+        @page = CallbackPage.new(watir_browser)
+        expect(@page.initialize_page_called).to be true
+      end
+
+      it "should call initialize_accessors if it exists" do
+        class CallbackPage
+          include PageObject
+          attr_reader :initialize_accessors_called
+
+          def initialize_accessors
+            @initialize_accessors_called = true
+          end
+        end
+
+        @page = CallbackPage.new(watir_browser)
+        expect(@page.initialize_accessors_called).to be true
+      end
+
+      it "should call initialize_accessors before initialize_page if both exist" do
+        class CallbackPage
+          include PageObject
+          attr_reader :initialize_page, :initialize_accessors
+
+          def initialize_page
+            @initialize_accessors = Time.now
+          end
+
+          def initialize_page
+            @initialize_accessors = Time.now
+          end
+        end
+
+        @page = CallbackPage.new(watir_browser)
+        expect(@page.initialize_accessors.usec).to be <= @page.initialize_page.usec
+      end
+
+      it "should know which element has focus" do
+        expect(watir_browser).to receive(:execute_script).and_return(watir_browser)
+        expect(watir_browser).to receive(:tag_name).twice.and_return(:input)
+        expect(watir_browser).to receive(:type).and_return(:submit)
+        expect(watir_page_object.element_with_focus.class).to eql PageObject::Elements::Button
+      end
+    end
+    
+    context "when using WatirPageObject" do
+      it "should display the page text" do
+        expect(watir_browser).to receive(:element).and_return(watir_browser)
+        expect(watir_browser).to receive(:text).and_return("browser text")
+        expect(watir_page_object.text).to eql "browser text"
+      end
+
+      it "should display the html of the page" do
+        expect(watir_browser).to receive(:html).and_return("<html>Some Sample HTML</html>")
+        expect(watir_page_object.html).to eql "<html>Some Sample HTML</html>"
+      end
+
+      it "should display the title of the page" do
+        expect(watir_browser).to receive(:title).and_return("I am the title of a page")
+        expect(watir_page_object.title).to eql "I am the title of a page"
+      end
+
+      it "should be able to navigate to a page" do
+        expect(watir_browser).to receive(:goto).with("cheezyworld.com")
+        watir_page_object.navigate_to("cheezyworld.com")
+      end
+
+      it "should wait until a block returns true" do
+        expect(watir_browser).to receive(:wait_until).with(5, "too long")
+        watir_page_object.wait_until(5, "too long")
+      end
+
+      it "should use the overriden timeout value when set" do
+        PageObject.default_page_wait = 10
+        expect(watir_browser).to receive(:wait_until).with(10, nil)
+        watir_page_object.wait_until
+      end
+
+      it "should wait until there are no pending ajax requests" do
+        expect(PageObject::JavascriptFrameworkFacade).to receive(:pending_requests).and_return('pending requests')
+        expect(watir_browser).to receive(:execute_script).with('pending requests').and_return(0)
+        watir_page_object.wait_for_ajax
+      end
+
+      it "should override alert popup behavior" do
+        expect(watir_browser).to receive(:alert).exactly(3).times.and_return(watir_browser)
+        expect(watir_browser).to receive(:exists?).and_return(true)
+        expect(watir_browser).to receive(:text)
+        expect(watir_browser).to receive(:ok)
+        watir_page_object.alert do
+        end
+      end
+
+      it "should override confirm popup behavior" do
+        expect(watir_browser).to receive(:alert).exactly(3).times.and_return(watir_browser)
+        expect(watir_browser).to receive(:exists?).and_return(true)
+        expect(watir_browser).to receive(:text)
+        expect(watir_browser).to receive(:ok)
+        watir_page_object.confirm(true) do
+        end
+      end
+
+      it "should override prompt popup behavior" do
+        expect(watir_browser).to receive(:wd).twice.and_return(watir_browser)
+        expect(watir_browser).to receive(:execute_script).twice
+        watir_page_object.prompt("blah") do
+        end
+      end
+
+      it "should execute javascript on the browser" do
+        expect(watir_browser).to receive(:execute_script).and_return("abc")
+        expect(watir_page_object.execute_script("333")).to eql "abc"
+      end
+      
+      it "should convert a modal popup to a window" do
+        expect(watir_browser).to receive(:execute_script)
+        watir_page_object.modal_dialog {}
+      end
+      
+      it "should switch to a new window with a given title" do
+        expect(watir_browser).to receive(:window).with(:title => /My\ Title/).and_return(watir_browser)
+        expect(watir_browser).to receive(:use)
+        watir_page_object.attach_to_window(:title => "My Title")
+      end
+      
+      it "should switch to a new window with a given url" do
+        expect(watir_browser).to receive(:window).with(:url => /success\.html/).and_return(watir_browser)
+        expect(watir_browser).to receive(:use)
+        watir_page_object.attach_to_window(:url => "success.html")
+      end
+      
+      it "should refresh the page contents" do
+        expect(watir_browser).to receive(:refresh)
+        watir_page_object.refresh
+      end
+
+      it "should know how to go back" do
+        expect(watir_browser).to receive(:back)
+        watir_page_object.back
+      end
+
+      it "should know how to go forward" do
+        expect(watir_browser).to receive(:forward)
+        watir_page_object.forward
+      end
+      
+      it "should know its' current url" do
+        expect(watir_browser).to receive(:url).and_return("cheezyworld.com")
+        expect(watir_page_object.current_url).to eql "cheezyworld.com"
+      end
+      
+      it "should know how to clear all of the cookies from the browser" do
+        expect(watir_browser).to receive(:cookies).and_return(watir_browser)
+        expect(watir_browser).to receive(:clear)
+        watir_page_object.clear_cookies
+      end
+      
+      it "should be able to save a screenshot" do
+        expect(watir_browser).to receive(:wd).and_return(watir_browser)
+        expect(watir_browser).to receive(:save_screenshot)
+        watir_page_object.save_screenshot("test.png")
+      end
+    end
+
+    context "when using SeleniumPageObject" do
+      it "should display the page text" do
+        expect(selenium_browser).to receive_messages(find_element: selenium_browser, text: 'browser text')
+        expect(selenium_page_object.text).to eql "browser text"
+      end
+
+      it "should display the html of the page" do
+        expect(selenium_browser).to receive(:page_source).and_return("<html>Some Sample HTML</html>")
+        expect(selenium_page_object.html).to eql "<html>Some Sample HTML</html>"
+      end
+
+      it "should display the title of the page" do
+        expect(selenium_browser).to receive(:title).and_return("I am the title of a page")
+        expect(selenium_page_object.title).to eql "I am the title of a page"
+      end
+
+      it "should be able to navigate to a page" do
+        expect(selenium_browser).to receive_messages(navigate: selenium_browser, to: 'cheezyworld.com')
+        selenium_page_object.navigate_to('cheezyworld.com')
+      end
+
+      it "should wait until a block returns true" do
+        wait = double('wait')
+        expect(Selenium::WebDriver::Wait).to receive(:new).with({:timeout => 5, :message => 'too long'}).and_return(wait)
+        expect(wait).to receive(:until)
+        selenium_page_object.wait_until(5, 'too long')
+      end
+
+      it "should wait until there are no pending ajax requests" do
+        expect(PageObject::JavascriptFrameworkFacade).to receive(:pending_requests).and_return('pending requests')
+        expect(selenium_browser).to receive(:execute_script).with('pending requests').and_return(0)
+        selenium_page_object.wait_for_ajax
+      end
+
+      it "should override alert popup behavior" do
+        expect(selenium_browser).to receive(:switch_to).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:alert).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:text)
+        expect(selenium_browser).to receive(:accept)
+        selenium_page_object.alert do
+        end
+      end
+
+      it "should override confirm popup behavior" do
+        expect(selenium_browser).to receive(:switch_to).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:alert).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:text)
+        expect(selenium_browser).to receive(:accept)
+        selenium_page_object.confirm(true) do
+        end
+      end
+      it "should override prompt popup behavior" do
+        expect(selenium_browser).to receive(:execute_script).twice
+        selenium_page_object.prompt("blah") do
+        end
+      end
+      
+      it "should convert a modal popup to a window" do
+        expect(selenium_browser).to receive(:execute_script)
+        selenium_page_object.modal_dialog {}
+      end
+      
+      it "should execute javascript on the browser" do
+        expect(selenium_browser).to receive(:execute_script).and_return("abc")
+        expect(selenium_page_object.execute_script("333")).to eql "abc"
+      end
+
+      it "should switch to a new window with a given title" do
+        expect(selenium_browser).to receive(:window_handles).and_return(["win1"])
+        expect(selenium_browser).to receive(:switch_to).twice.and_return(selenium_browser)
+        expect(selenium_browser).to receive(:window).twice.with("win1").and_return(selenium_browser)
+        expect(selenium_browser).to receive(:title).and_return("My Title")
+        selenium_page_object.attach_to_window(:title => "My Title")
+      end
+      
+      it "should switch to a new window with a given url" do
+        expect(selenium_browser).to receive(:window_handles).and_return(["win1"])
+        expect(selenium_browser).to receive(:switch_to).twice.and_return(selenium_browser)
+        expect(selenium_browser).to receive(:window).twice.with("win1").and_return(selenium_browser)
+        expect(selenium_browser).to receive(:current_url).and_return("page.html")
+        selenium_page_object.attach_to_window(:url => "page.html")
+      end
+      
+      it "should refresh the page contents" do
+        expect(selenium_browser).to receive(:navigate).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:refresh)
+        selenium_page_object.refresh
+      end
+      
+      it "should know how to go back" do
+        expect(selenium_browser).to receive(:navigate).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:back)
+        selenium_page_object.back
+      end
+      
+      it "should know how to go forward" do
+        expect(selenium_browser).to receive(:navigate).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:forward)
+        selenium_page_object.forward
+      end
+      
+      it "should know its' current url" do
+        expect(selenium_browser).to receive(:current_url).and_return("cheezyworld.com")
+        expect(selenium_page_object.current_url).to eql "cheezyworld.com"
+      end
+      
+      it "should clear all of the cookies from the browser" do
+        expect(selenium_browser).to receive(:manage).and_return(selenium_browser)
+        expect(selenium_browser).to receive(:delete_all_cookies)
+        selenium_page_object.clear_cookies
+      end
+      
+      it "should be able to save a screenshot" do
+        expect(selenium_browser).to receive(:save_screenshot)
+        selenium_page_object.save_screenshot("test.png")
+      end
+    end
+  end
+end