capybara 1.1.4 → 2.0.0.beta2

data/lib/capybara/spec/session/screenshot.rb

@@ -0,0 +1,29 @@
+shared_examples_for "session with screenshot support" do
+  describe "#save_screenshot" do
+    let(:image_path) { File.join(Dir.tmpdir, 'capybara-screenshot.png') }
+
+    before do
+      @session.visit '/'
+      @session.save_screenshot image_path
+    end
+
+    it "should generate PNG file" do
+      magic = File.read(image_path, 4)
+      magic.should eq "\x89PNG"
+    end
+  end
+end
+
+shared_examples_for "session without screenshot support" do
+  describe "#save_screenshot" do
+    before do
+      @session.visit('/')
+    end
+
+    it "should raise an error" do
+      running {
+        @session.save_screenshot 'raise_error.png'
+      }.should raise_error(Capybara::NotSupportedByDriverError)
+    end
+  end
+end

data/lib/capybara/spec/session/select_spec.rb

@@ -30,15 +30,9 @@ shared_examples_for "select" do
     end
 
     it "should select an option without giving a select box" do
-      @session.select("Mr")
+      @session.select("Swedish")
       @session.click_button('awesome')
-      extract_results(@session)['title'].should == 'Mr'
-    end
-
-    it "should favour exact matches to option labels" do
-      @session.select("Mr", :from => 'Title')
-      @session.click_button('awesome')
-      extract_results(@session)['title'].should == 'Mr'
+      extract_results(@session)['locale'].should == 'sv'
     end
 
     it "should escape quotes" do
@@ -63,13 +57,19 @@ shared_examples_for "select" do
 
     context "with a locator that doesn't exist" do
       it "should raise an error" do
-        running { @session.select('foo', :from => 'does not exist') }.should raise_error(Capybara::ElementNotFound)
+        msg = "Unable to find select box \"does not exist\""
+        running do
+          @session.select('foo', :from => 'does not exist')
+        end.should raise_error(Capybara::ElementNotFound, msg)
       end
     end
 
     context "with an option that doesn't exist" do
       it "should raise an error" do
-        running { @session.select('Does not Exist', :from => 'form_locale') }.should raise_error(Capybara::ElementNotFound)
+        msg = "Unable to find option \"Does not Exist\""
+        running do
+          @session.select('Does not Exist', :from => 'form_locale')
+        end.should raise_error(Capybara::ElementNotFound, msg)
       end
     end
 
@@ -96,7 +96,7 @@ shared_examples_for "select" do
         @session.click_button('awesome')
         extract_results(@session)['languages'].should include('Ruby', 'Javascript')
       end
-      
+
       it "should remain selected if already selected" do
         @session.select("Ruby",       :from => 'Language')
         @session.select("Javascript", :from => 'Language')
@@ -104,7 +104,7 @@ shared_examples_for "select" do
         @session.click_button('awesome')
         extract_results(@session)['languages'].should include('Ruby', 'Javascript')
       end
-      
+
       it "should return value attribute rather than content if present" do
         @session.find_field('Underwear').value.should include('thermal')
       end

data/lib/capybara/spec/session/text_spec.rb

@@ -1,19 +1,24 @@
 shared_examples_for "text" do
   describe '#text' do
-    before do
-      @session.visit('/with_simple_html')
-    end
-
     it "should print the text of the page" do
+      @session.visit('/with_simple_html')
       @session.text.should == 'Bar'
     end
 
     context "with css as default selector" do
       before { Capybara.default_selector = :css }
       it "should print the text of the page" do
+        @session.visit('/with_simple_html')
         @session.text.should == 'Bar'
       end
       after { Capybara.default_selector = :xpath }
     end
+
+    it "should strip whitespace" do
+      @session.visit('/with_html')
+      n = @session.find(:css, '#second')
+      @session.find(:css, '#second').text.should =~ \
+        /\ADuis aute .* text with whitespace .* est laborum\.\z/
+    end
   end
 end

data/lib/capybara/spec/session/unselect_spec.rb

@@ -8,28 +8,28 @@ shared_examples_for "unselect" do
       it "should unselect an option from a select box by id" do
         @session.unselect('Commando', :from => 'form_underwear')
         @session.click_button('awesome')
-        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxerbriefs')
         extract_results(@session)['underwear'].should_not include('Commando')
       end
 
       it "should unselect an option without a select box" do
         @session.unselect('Commando')
         @session.click_button('awesome')
-        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxerbriefs')
         extract_results(@session)['underwear'].should_not include('Commando')
       end
 
       it "should unselect an option from a select box by label" do
         @session.unselect('Commando', :from => 'Underwear')
         @session.click_button('awesome')
-        extract_results(@session)['underwear'].should include('Briefs', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should include('Briefs', 'Boxerbriefs')
         extract_results(@session)['underwear'].should_not include('Commando')
       end
 
       it "should favour exact matches to option labels" do
         @session.unselect("Briefs", :from => 'Underwear')
         @session.click_button('awesome')
-        extract_results(@session)['underwear'].should include('Commando', 'Boxer Briefs')
+        extract_results(@session)['underwear'].should include('Commando', 'Boxerbriefs')
         extract_results(@session)['underwear'].should_not include('Briefs')
       end
 
@@ -48,13 +48,19 @@ shared_examples_for "unselect" do
 
     context "with a locator that doesn't exist" do
       it "should raise an error" do
-        running { @session.unselect('foo', :from => 'does not exist') }.should raise_error(Capybara::ElementNotFound)
+        msg = "Unable to find select box \"does not exist\""
+        running do
+          @session.unselect('foo', :from => 'does not exist')
+        end.should raise_error(Capybara::ElementNotFound, msg)
       end
     end
 
     context "with an option that doesn't exist" do
       it "should raise an error" do
-        running { @session.unselect('Does not Exist', :from => 'form_underwear') }.should raise_error(Capybara::ElementNotFound)
+        msg = "Unable to find option \"Does not Exist\""
+        running do
+          @session.unselect('Does not Exist', :from => 'form_underwear')
+        end.should raise_error(Capybara::ElementNotFound, msg)
       end
     end
   end

data/lib/capybara/spec/session/visit_spec.rb

@@ -0,0 +1,76 @@
+shared_examples_for "visit" do
+  describe '#visit' do
+    it "should fetch a response from the driver with a relative url" do
+      @session.visit('/')
+      @session.body.should include('Hello world!')
+      @session.visit('/foo')
+      @session.body.should include('Another World')
+    end
+
+    it "should fetch a response from the driver with an absolute url with a port" do
+      # Preparation
+      @session.visit('/')
+      root_uri = URI.parse(@session.current_url)
+
+      @session.visit("http://#{root_uri.host}:#{root_uri.port}/")
+      @session.body.should include('Hello world!')
+      @session.visit("http://#{root_uri.host}:#{root_uri.port}/foo")
+      @session.body.should include('Another World')
+    end
+
+    context "when Capybara.always_include_port is true" do
+
+      let(:root_uri) do
+        @session.visit('/')
+        URI.parse(@session.current_url)
+      end
+
+      before(:each) do
+        Capybara.always_include_port = true
+      end
+
+      after(:each) do
+        Capybara.always_include_port = false
+      end
+
+      it "should fetch a response from the driver with an absolute url without a port" do
+        @session.visit("http://#{root_uri.host}/")
+        URI.parse(@session.current_url).port.should == root_uri.port
+        @session.body.should include('Hello world!')
+
+        @session.visit("http://#{root_uri.host}/foo")
+        URI.parse(@session.current_url).port.should == root_uri.port
+        @session.body.should include('Another World')
+      end
+    end
+
+    it "should send no referer when visiting a page" do
+      @session.visit '/get_referer'
+      @session.body.should include 'No referer'
+    end
+
+    it "should send no referer when visiting a second page" do
+      @session.visit '/get_referer'
+      @session.visit '/get_referer'
+      @session.body.should include 'No referer'
+    end
+
+    it "should send a referer when following a link" do
+      @session.visit '/referer_base'
+      @session.find('//a[@href="/get_referer"]').click
+      @session.body.should match %r{http://.*/referer_base}
+    end
+
+    it "should preserve the original referer URL when following a redirect" do
+      @session.visit('/referer_base')
+      @session.find('//a[@href="/redirect_to_get_referer"]').click
+      @session.body.should match %r{http://.*/referer_base}
+    end
+
+    it "should send a referer when submitting a form" do
+      @session.visit '/referer_base'
+      @session.find('//input').click
+      @session.body.should match %r{http://.*/referer_base}
+    end
+  end
+end

data/lib/capybara/spec/session/within_frame_spec.rb

@@ -0,0 +1,33 @@
+shared_examples_for "session with frame support" do
+  describe '#within_frame' do
+    before(:each) do
+      @session.visit('/within_frames')
+    end
+
+    it "should find the div in frameOne" do
+      @session.within_frame("frameOne") do
+        @session.find("//*[@id='divInFrameOne']").text.should eql 'This is the text of divInFrameOne'
+      end
+    end
+    it "should find the div in FrameTwo" do
+      @session.within_frame("frameTwo") do
+        @session.find("//*[@id='divInFrameTwo']").text.should eql 'This is the text of divInFrameTwo'
+      end
+    end
+    it "should find the text div in the main window after finding text in frameOne" do
+      @session.within_frame("frameOne") do
+        @session.find("//*[@id='divInFrameOne']").text.should eql 'This is the text of divInFrameOne'
+      end
+      @session.find("//*[@id='divInMainWindow']").text.should eql 'This is the text for divInMainWindow'
+    end
+    it "should find the text div in the main window after finding text in frameTwo" do
+      @session.within_frame("frameTwo") do
+        @session.find("//*[@id='divInFrameTwo']").text.should eql 'This is the text of divInFrameTwo'
+      end
+      @session.find("//*[@id='divInMainWindow']").text.should eql 'This is the text for divInMainWindow'
+    end
+    it "should return the result of executing the block" do
+      @session.within_frame("frameOne") { "return value" }.should eql "return value"
+    end
+  end
+end

data/lib/capybara/spec/session/within_spec.rb

@@ -6,7 +6,7 @@ shared_examples_for "within" do
 
     context "with CSS selector" do
       it "should click links in the given scope" do
-        @session.within(:css, "ul li[contains('With Simple HTML')]") do
+        @session.within(:css, "#for_bar li[contains('With Simple HTML')]") do
           @session.click_link('Go')
         end
         @session.body.should include('Bar')
@@ -20,7 +20,7 @@ shared_examples_for "within" do
       end
 
       it "should accept additional options" do
-        @session.within(:css, "ul li", :text => 'With Simple HTML') do
+        @session.within(:css, "#for_bar li", :text => 'With Simple HTML') do
           @session.click_link('Go')
         end
         @session.body.should include('Bar')
@@ -29,7 +29,7 @@ shared_examples_for "within" do
 
     context "with XPath selector" do
       it "should click links in the given scope" do
-        @session.within(:xpath, "//li[contains(.,'With Simple HTML')]") do
+        @session.within(:xpath, "//div[@id='for_bar']//li[contains(.,'With Simple HTML')]") do
           @session.click_link('Go')
         end
         @session.body.should include('Bar')
@@ -38,7 +38,7 @@ shared_examples_for "within" do
 
     context "with the default selector" do
       it "should use XPath" do
-        @session.within("//li[contains(., 'With Simple HTML')]") do
+        @session.within("//div[@id='for_bar']//li[contains(.,'With Simple HTML')]") do
           @session.click_link('Go')
         end
         @session.body.should include('Bar')
@@ -47,9 +47,9 @@ shared_examples_for "within" do
 
     context "with Node rather than selector" do
       it "should click links in the given scope" do
-        node_of_interest = @session.find(:css, "ul li[contains('With Simple HTML')]")
+        node_of_interest = @session.find(:css, "#for_bar li[contains('With Simple HTML')]")
 
-        @session.within(node_of_interest) do 
+        @session.within(node_of_interest) do
           @session.click_link('Go')
         end
         @session.body.should include('Bar')
@@ -59,7 +59,7 @@ shared_examples_for "within" do
     context "with the default selector set to CSS" do
       before { Capybara.default_selector = :css }
       it "should use CSS" do
-        @session.within("ul li[contains('With Simple HTML')]") do
+        @session.within("#for_bar li[contains('With Simple HTML')]") do
           @session.click_link('Go')
         end
         @session.body.should include('Bar')
@@ -67,68 +67,57 @@ shared_examples_for "within" do
       after { Capybara.default_selector = :xpath }
     end
 
-    context "with click_link" do
-      it "should click links in the given scope" do
-        @session.within("//li[contains(.,'With Simple HTML')]") do
-          @session.click_link('Go')
-        end
-        @session.body.should include('Bar')
-      end
-
-      context "with nested scopes" do
-        it "should respect the inner scope" do
-          @session.within("//div[@id='for_bar']") do
-            @session.within(".//li[contains(.,'Bar')]") do
-              @session.click_link('Go')
-            end
+    context "with nested scopes" do
+      it "should respect the inner scope" do
+        @session.within("//div[@id='for_bar']") do
+          @session.within(".//li[contains(.,'Bar')]") do
+            @session.click_link('Go')
           end
-          @session.body.should include('Another World')
-        end
-
-        it "should respect the outer scope" do
-          @session.within("//div[@id='another_foo']") do
-            @session.within(".//li[contains(.,'With Simple HTML')]") do
-              @session.click_link('Go')
-            end
-          end
-          @session.body.should include('Hello world')
         end
+        @session.body.should include('Another World')
       end
 
-      it "should raise an error if the scope is not found on the page" do
-        running {
-          @session.within("//div[@id='doesnotexist']") do
+      it "should respect the outer scope" do
+        @session.within("//div[@id='another_foo']") do
+          @session.within(".//li[contains(.,'With Simple HTML')]") do
+            @session.click_link('Go')
           end
-        }.should raise_error(Capybara::ElementNotFound)
-      end
-
-      it "should restore the scope when an error is raised" do
-        running {
-          @session.within("//div[@id='for_bar']") do
-            running {
-              running {
-                @session.within(".//div[@id='doesnotexist']") do
-                end
-              }.should raise_error(Capybara::ElementNotFound)
-            }.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
-          end
-        }.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(true)
+        end
+        @session.body.should include('Hello world')
       end
     end
 
-    context "with forms" do
-      it "should fill in a field and click a button" do
-        @session.within("//li[contains(.,'Bar')]") do
-          @session.click_button('Go')
+    it "should raise an error if the scope is not found on the page" do
+      running do
+        @session.within("//div[@id='doesnotexist']") do
         end
-        extract_results(@session)['first_name'].should == 'Peter'
-        @session.visit('/with_scope')
-        @session.within("//li[contains(.,'Bar')]") do
-          @session.fill_in('First Name', :with => 'Dagobert')
-          @session.click_button('Go')
+      end.should raise_error(Capybara::ElementNotFound)
+    end
+
+    it "should restore the scope when an error is raised" do
+      running do
+        @session.within("//div[@id='for_bar']") do
+          running do
+            running do
+              @session.within(".//div[@id='doesnotexist']") do
+              end
+            end.should raise_error(Capybara::ElementNotFound)
+          end.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(false)
         end
-        extract_results(@session)['first_name'].should == 'Dagobert'
+      end.should_not change { @session.has_xpath?(".//div[@id='another_foo']") }.from(true)
+    end
+
+    it "should fill in a field and click a button" do
+      @session.within("//li[contains(.,'Bar')]") do
+        @session.click_button('Go')
+      end
+      extract_results(@session)['first_name'].should == 'Peter'
+      @session.visit('/with_scope')
+      @session.within("//li[contains(.,'Bar')]") do
+        @session.fill_in('First Name', :with => 'Dagobert')
+        @session.click_button('Go')
       end
+      extract_results(@session)['first_name'].should == 'Dagobert'
     end
   end
 

data/lib/capybara/spec/session/within_window_spec.rb

@@ -0,0 +1,40 @@
+shared_examples_for "session with window support" do
+  describe '#within_window' do
+    before(:each) do
+      @session.visit('/within_popups')
+    end
+    after(:each) do
+      @session.within_window("firstPopup") do
+        @session.evaluate_script('window.close()')
+      end
+      @session.within_window("secondPopup") do
+        @session.evaluate_script('window.close()')
+      end
+    end
+
+    it "should find the div in firstPopup" do
+      @session.within_window("firstPopup") do
+        @session.find("//*[@id='divInPopupOne']").text.should eql 'This is the text of divInPopupOne'
+      end
+    end
+    it "should find the div in secondPopup" do
+      @session.within_window("secondPopup") do
+        @session.find("//*[@id='divInPopupTwo']").text.should eql 'This is the text of divInPopupTwo'
+      end
+    end
+    it "should find the divs in both popups" do
+      @session.within_window("secondPopup") do
+        @session.find("//*[@id='divInPopupTwo']").text.should eql 'This is the text of divInPopupTwo'
+      end
+      @session.within_window("firstPopup") do
+        @session.find("//*[@id='divInPopupOne']").text.should eql 'This is the text of divInPopupOne'
+      end
+    end
+    it "should find the div in the main window after finding a div in a popup" do
+      @session.within_window("secondPopup") do
+        @session.find("//*[@id='divInPopupTwo']").text.should eql 'This is the text of divInPopupTwo'
+      end
+      @session.find("//*[@id='divInMainWindow']").text.should eql 'This is the text for divInMainWindow'
+    end
+  end
+end