capybara_minitest_spec 0.1.0

data/test_app/driver.rb

@@ -0,0 +1,297 @@
+require 'capybara/spec/test_app'
+
+shared_examples_for 'driver' do
+
+  describe '#visit' do
+    it "should move to another page" do
+      @driver.visit('/')
+      @driver.body.should include('Hello world!')
+      @driver.visit('/foo')
+      @driver.body.should include('Another World')
+    end
+
+    it "should show the correct URL" do
+      @driver.visit('/foo')
+      @driver.current_url.should include('/foo')
+    end
+  end
+
+  describe '#body' do
+    it "should return text reponses" do
+      @driver.visit('/')
+      @driver.body.should include('Hello world!')
+    end
+
+    it "should return the full response html" do
+      @driver.visit('/with_simple_html')
+      @driver.body.should include('Bar')
+    end
+
+    if "".respond_to?(:encoding)
+      context "encoding of response between ascii and utf8" do
+        it "should be valid with html entities" do
+          @driver.visit('/with_html_entities')
+          lambda { @driver.body.encode!("UTF-8") }.should_not raise_error
+        end
+
+        it "should be valid without html entities" do
+          @driver.visit('/with_html')
+          lambda { @driver.body.encode!("UTF-8") }.should_not raise_error
+        end
+      end
+    end
+  end
+
+  describe '#find' do
+    context "with xpath selector" do
+      before do
+        @driver.visit('/with_html')
+      end
+
+      it "should extract node texts" do
+        @driver.find('//a')[0].text.should == 'labore'
+        @driver.find('//a')[1].text.should == 'ullamco'
+      end
+
+      it "should extract node attributes" do
+        @driver.find('//a')[0][:class].should == 'simple'
+        @driver.find('//a')[1][:id].should == 'foo'
+        @driver.find('//input')[0][:type].should == 'text'
+      end
+
+      it "should extract boolean node attributes" do
+        @driver.find('//input[@id="checked_field"]')[0][:checked].should be_true
+      end
+
+      it "should allow retrieval of the value" do
+        @driver.find('//textarea').first.value.should == 'banana'
+      end
+
+      it "should allow assignment of field value" do
+        @driver.find('//input').first.value.should == 'monkey'
+        @driver.find('//input').first.set('gorilla')
+        @driver.find('//input').first.value.should == 'gorilla'
+      end
+
+      it "should extract node tag name" do
+        @driver.find('//a')[0].tag_name.should == 'a'
+        @driver.find('//a')[1].tag_name.should == 'a'
+        @driver.find('//p')[1].tag_name.should == 'p'
+      end
+
+      it "should extract node visibility" do
+        @driver.find('//a')[0].should be_visible
+
+        @driver.find('//div[@id="hidden"]')[0].should_not be_visible
+        @driver.find('//div[@id="hidden_via_ancestor"]')[0].should_not be_visible
+      end
+
+      it "should extract node checked state" do
+        @driver.visit('/form')
+        @driver.find('//input[@id="gender_female"]')[0].should be_checked
+        @driver.find('//input[@id="gender_male"]')[0].should_not be_checked
+        @driver.find('//h1')[0].should_not be_checked
+      end
+
+      it "should extract node selected state" do
+        @driver.visit('/form')
+        @driver.find('//option[@value="en"]')[0].should be_selected
+        @driver.find('//option[@value="sv"]')[0].should_not be_selected
+        @driver.find('//h1')[0].should_not be_selected
+      end
+
+      it "should return document text on /html selector" do
+        @driver.visit('/with_simple_html')
+        @driver.find('/html')[0].text.should == 'Bar'
+      end
+    end
+  end
+end
+
+shared_examples_for "driver with javascript support" do
+  before { @driver.visit('/with_js') }
+
+  describe '#find' do
+    it "should find dynamically changed nodes" do
+      @driver.find('//p').first.text.should == 'I changed it'
+    end
+  end
+
+  describe '#drag_to' do
+    it "should drag and drop an object" do
+      draggable = @driver.find('//div[@id="drag"]').first
+      droppable = @driver.find('//div[@id="drop"]').first
+      draggable.drag_to(droppable)
+      @driver.find('//div[contains(., "Dropped!")]').should_not be_empty
+    end
+  end
+
+  describe "#evaluate_script" do
+    it "should return the value of the executed script" do
+      @driver.evaluate_script('1+1').should == 2
+    end
+  end
+
+end
+
+shared_examples_for "driver with resynchronization support" do
+  before { @driver.visit('/with_js') }
+  describe "#find" do
+    context "with synchronization turned on" do
+      before { @driver.options[:resynchronize] = true }
+      it "should wait for all ajax requests to finish" do
+        @driver.find('//input[@id="fire_ajax_request"]').first.click
+        @driver.find('//p[@id="ajax_request_done"]').should_not be_empty
+      end
+    end
+
+    context "with resynchronization turned off" do
+      before { @driver.options[:resynchronize] = false }
+      it "should not wait for ajax requests to finish" do
+        @driver.find('//input[@id="fire_ajax_request"]').first.click
+        @driver.find('//p[@id="ajax_request_done"]').should be_empty
+      end
+    end
+
+    context "with short synchronization timeout" do
+      before { @driver.options[:resynchronize] = true }
+      before { @driver.options[:resynchronization_timeout] = 0.1 }
+
+      it "should raise an error" do
+        expect do
+          @driver.find('//input[@id="fire_ajax_request"]').first.click
+        end.to raise_error(Capybara::TimeoutError, "failed to resynchronize, ajax request timed out")
+      end
+    end
+  end
+
+  after { @driver.options[:resynchronize] = false }
+  after { @driver.options[:resynchronization_timeout] = 10 }
+end
+
+shared_examples_for "driver with header support" do
+  it "should make headers available through response_headers" do
+    @driver.visit('/with_simple_html')
+    @driver.response_headers['Content-Type'].should =~ /text\/html/
+  end
+end
+
+shared_examples_for "driver with status code support" do
+  it "should make the status code available through status_code" do
+    @driver.visit('/with_simple_html')
+    @driver.status_code.should == 200
+  end
+end
+
+shared_examples_for "driver without status code support" do
+  it "should raise when trying to access the status code available through status_code" do
+    @driver.visit('/with_simple_html')
+    lambda {
+      @driver.status_code
+    }.should raise_error(Capybara::NotSupportedByDriverError)
+  end
+end
+
+shared_examples_for "driver with frame support" do
+  describe '#within_frame' do
+    before(:each) do
+      @driver.visit('/within_frames')
+    end
+
+    it "should find the div in frameOne" do
+      @driver.within_frame("frameOne") do
+        @driver.find("//*[@id='divInFrameOne']")[0].text.should eql 'This is the text of divInFrameOne'
+      end
+    end
+    it "should find the div in FrameTwo" do
+      @driver.within_frame("frameTwo") do
+        @driver.find("//*[@id='divInFrameTwo']")[0].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
+      @driver.within_frame("frameOne") do
+        @driver.find("//*[@id='divInFrameOne']")[0].text.should eql 'This is the text of divInFrameOne'
+      end
+      @driver.find("//*[@id='divInMainWindow']")[0].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
+      @driver.within_frame("frameTwo") do
+        @driver.find("//*[@id='divInFrameTwo']")[0].text.should eql 'This is the text of divInFrameTwo'
+      end
+      @driver.find("//*[@id='divInMainWindow']")[0].text.should eql 'This is the text for divInMainWindow'
+    end
+  end
+end
+
+shared_examples_for "driver with support for window switching" do
+  describe '#within_window' do
+    before(:each) do
+      @driver.visit('/within_popups')
+    end
+    after(:each) do
+      @driver.within_window("firstPopup") do
+        @driver.evaluate_script('window.close()')
+      end
+      @driver.within_window("secondPopup") do
+        @driver.evaluate_script('window.close()')
+      end
+    end
+
+    it "should find the div in firstPopup" do
+      @driver.within_window("firstPopup") do
+        @driver.find("//*[@id='divInPopupOne']")[0].text.should eql 'This is the text of divInPopupOne'
+      end
+    end
+    it "should find the div in secondPopup" do
+      @driver.within_window("secondPopup") do
+        @driver.find("//*[@id='divInPopupTwo']")[0].text.should eql 'This is the text of divInPopupTwo'
+      end
+    end
+    it "should find the divs in both popups" do
+      @driver.within_window("secondPopup") do
+        @driver.find("//*[@id='divInPopupTwo']")[0].text.should eql 'This is the text of divInPopupTwo'
+      end
+      @driver.within_window("firstPopup") do
+        @driver.find("//*[@id='divInPopupOne']")[0].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
+      @driver.within_window("secondPopup") do
+        @driver.find("//*[@id='divInPopupTwo']")[0].text.should eql 'This is the text of divInPopupTwo'
+      end
+      @driver.find("//*[@id='divInMainWindow']")[0].text.should eql 'This is the text for divInMainWindow'
+    end
+  end
+end
+
+shared_examples_for "driver with cookies support" do
+  describe "#reset!" do
+    it "should set and clean cookies" do
+      @driver.visit('/get_cookie')
+      @driver.body.should_not include('test_cookie')
+
+      @driver.visit('/set_cookie')
+      @driver.body.should include('Cookie set to test_cookie')
+
+      @driver.visit('/get_cookie')
+      @driver.body.should include('test_cookie')
+
+      @driver.reset!
+      @driver.visit('/get_cookie')
+      @driver.body.should_not include('test_cookie')
+    end
+  end
+end
+
+shared_examples_for "driver with infinite redirect detection" do
+  it "should follow 5 redirects" do
+    @driver.visit('/redirect/5/times')
+    @driver.body.should include('redirection complete')
+  end
+
+  it "should not follow more than 5 redirects" do
+    running do
+      @driver.visit('/redirect/6/times')
+    end.should raise_error(Capybara::InfiniteRedirectError)
+  end
+end

data/test_app/fixtures/capybara.jpg

@@ -0,0 +1,3 @@
+This is a jpeg file :) Since it is rendered in the
+view it doesn't actually contain any binary data,
+as that would cause Nokogiri to go mad.

data/test_app/fixtures/test_file.txt

@@ -0,0 +1 @@
+ThisIsTheTestFile

data/test_app/public/test.js

@@ -0,0 +1,43 @@
+var activeRequests = 0;
+$(function() {
+  $('#change').text('I changed it');
+  $('#drag').draggable();
+  $('#drop').droppable({
+    drop: function(event, ui) {
+      ui.draggable.remove();
+      $(this).html('Dropped!');
+    }
+  });
+  $('#clickable').click(function() {
+    var link = $(this);
+    setTimeout(function() {
+      $(link).after('<a id="has-been-clicked" href="#">Has been clicked</a>');
+      $(link).after('<input type="submit" value="New Here">');
+      $(link).after('<input type="text" id="new_field">');
+      $('#change').remove();
+    }, 500);
+    return false;
+  });
+  $('#waiter').change(function() {
+    activeRequests = 1;
+    setTimeout(function() {
+      activeRequests = 0;
+    }, 500);
+  });
+  $('#with_focus_event').focus(function() {
+    $('body').append('<p id="focus_event_triggered">Focus Event triggered</p>');
+  });
+  $('#checkbox_with_event').click(function() {
+    $('body').append('<p id="checkbox_event_triggered">Checkbox event triggered</p>');
+  });
+  $('#fire_ajax_request').click(function() {
+    $.ajax({url: "/slow_response", context: document.body, success: function() {
+      $('body').append('<p id="ajax_request_done">Ajax request done</p>');
+    }});
+  });
+  $('#reload-link').click(function() {
+    setTimeout(function() {
+      $('#reload-me').replaceWith('<div id="reload-me"><em><a>RELOADED</a></em></div>');
+    }, 250)
+  });
+});

data/test_app/session/all_spec.rb

@@ -0,0 +1,78 @@
+shared_examples_for "all" do
+  describe '#all' do
+    before do
+      @session.visit('/with_html')
+    end
+
+    it "should find all elements using the given locator" do
+      @session.all('//p').should have(3).elements
+      @session.all('//h1').first.text.should == 'This is a test'
+      @session.all("//input[@id='test_field']").first[:value].should == 'monkey'
+    end
+
+    it "should return an empty array when nothing was found" do
+      @session.all('//div[@id="nosuchthing"]').should be_empty
+    end
+
+    it "should accept an XPath instance" do
+      @session.visit('/form')
+      @xpath = XPath::HTML.fillable_field('Name')
+      @result = @session.all(@xpath).map { |r| r.value }
+      @result.should include('Smith', 'John', 'John Smith')
+    end
+
+    context "with css selectors" do
+      it "should find all elements using the given selector" do
+        @session.all(:css, 'h1').first.text.should == 'This is a test'
+        @session.all(:css, "input[id='test_field']").first[:value].should == 'monkey'
+      end
+
+      it "should find all elements when given a list of selectors" do
+        @session.all(:css, 'h1, p').should have(4).elements
+      end
+    end
+
+    context "with xpath selectors" do
+      it "should find the first element using the given locator" do
+        @session.all(:xpath, '//h1').first.text.should == 'This is a test'
+        @session.all(:xpath, "//input[@id='test_field']").first[:value].should == 'monkey'
+      end
+    end
+
+    context "with css as default selector" do
+      before { Capybara.default_selector = :css }
+      it "should find the first element using the given locator" do
+        @session.all('h1').first.text.should == 'This is a test'
+        @session.all("input[id='test_field']").first[:value].should == 'monkey'
+      end
+      after { Capybara.default_selector = :xpath }
+    end
+
+    context "with visible filter" do
+      after { Capybara.ignore_hidden_elements = false }
+      it "should only find visible nodes" do
+        @session.all("//a[@title='awesome title']").should have(2).elements
+        @session.all("//a[@title='awesome title']", :visible => true).should have(1).elements
+        Capybara.ignore_hidden_elements = true
+        @session.all("//a[@title='awesome title']").should have(1).elements
+      end
+
+      it "should only find invisible nodes" do
+        Capybara.ignore_hidden_elements = true
+        @session.all("//a[@title='awesome title']", :visible => false).should have(2).elements
+      end
+    end
+
+    context "within a scope" do
+      before do
+        @session.visit('/with_scope')
+      end
+
+      it "should find any element using the given locator" do
+        @session.within(:xpath, "//div[@id='for_bar']") do
+          @session.all('.//li').should have(2).elements
+        end
+      end
+    end
+  end
+end

data/test_app/session/attach_file_spec.rb

@@ -0,0 +1,73 @@
+shared_examples_for "attach_file" do
+
+  describe "#attach_file" do
+    before do
+      @test_file_path = File.expand_path('../fixtures/test_file.txt', File.dirname(__FILE__))
+      @test_jpg_file_path = File.expand_path('../fixtures/capybara.jpg', File.dirname(__FILE__))
+      @session.visit('/form')
+    end
+
+    context "with normal form" do
+      it "should set a file path by id" do
+        @session.attach_file "form_image", __FILE__
+        @session.click_button('awesome')
+        extract_results(@session)['image'].should == File.basename(__FILE__)
+      end
+
+      it "should set a file path by label" do
+        @session.attach_file "Image", __FILE__
+        @session.click_button('awesome')
+        extract_results(@session)['image'].should == File.basename(__FILE__)
+      end
+    end
+
+    context "with multipart form" do
+      it "should set a file path by id" do
+        @session.attach_file "form_document", @test_file_path
+        @session.click_button('Upload')
+        @session.body.should include(File.read(@test_file_path))
+      end
+
+      it "should set a file path by label" do
+        @session.attach_file "Document", @test_file_path
+        @session.click_button('Upload')
+        @session.body.should include(File.read(@test_file_path))
+      end
+
+      it "should not break if no file is submitted" do
+        @session.click_button('Upload')
+        @session.body.should include('No file uploaded')
+      end
+
+      it "should send content type text/plain when uploading a text file" do
+        @session.attach_file "Document", @test_file_path
+        @session.click_button 'Upload'
+        @session.body.should include('text/plain')
+      end
+
+      it "should send content type image/jpeg when uploading an image" do
+        @session.attach_file "Document", @test_jpg_file_path
+        @session.click_button 'Upload'
+        @session.body.should include('image/jpeg')
+      end
+
+      it  "should not break when using HTML5 multiple file input" do
+        @session.attach_file "Multiple Documents", @test_file_path
+        @session.click_button('Upload Multiple')
+        @session.body.should include(File.read(@test_file_path))
+      end
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.attach_file('does not exist', @test_file_path) }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    context "with a path that doesn't exist" do
+      it "should raise an error" do
+        running { @session.attach_file('Image', '/no_such_file.png') }.should raise_error(Capybara::FileNotFound)
+      end
+    end
+  end
+end

data/test_app/session/check_spec.rb

@@ -0,0 +1,65 @@
+shared_examples_for "check" do
+
+  describe "#check" do
+    before do
+      @session.visit('/form')
+    end
+    
+    describe "'checked' attribute" do
+      it "should be true if checked" do
+        @session.check("Terms of Use")
+        @session.find(:xpath, "//input[@id='form_terms_of_use']")['checked'].should be_true
+      end
+      
+      it "should be false if unchecked" do
+        @session.find(:xpath, "//input[@id='form_terms_of_use']")['checked'].should be_false
+      end
+    end
+
+    describe "checking" do
+      it "should not change an already checked checkbox" do
+        @session.find(:xpath, "//input[@id='form_pets_dog']")['checked'].should be_true
+        @session.check('form_pets_dog')
+        @session.find(:xpath, "//input[@id='form_pets_dog']")['checked'].should be_true
+      end
+
+      it "should check an unchecked checkbox" do
+        @session.find(:xpath, "//input[@id='form_pets_cat']")['checked'].should be_false
+        @session.check('form_pets_cat')
+        @session.find(:xpath, "//input[@id='form_pets_cat']")['checked'].should be_true
+      end
+    end
+
+    describe "unchecking" do
+      it "should not change an already unchecked checkbox" do
+        @session.find(:xpath, "//input[@id='form_pets_cat']")['checked'].should be_false
+        @session.uncheck('form_pets_cat')
+        @session.find(:xpath, "//input[@id='form_pets_cat']")['checked'].should be_false
+      end
+
+      it "should uncheck a checked checkbox" do
+        @session.find(:xpath, "//input[@id='form_pets_dog']")['checked'].should be_true
+        @session.uncheck('form_pets_dog')
+        @session.find(:xpath, "//input[@id='form_pets_dog']")['checked'].should be_false
+      end
+    end
+
+    it "should check a checkbox by id" do
+      @session.check("form_pets_cat")
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should include('dog', 'cat', 'hamster')
+    end
+
+    it "should check a checkbox by label" do
+      @session.check("Cat")
+      @session.click_button('awesome')
+      extract_results(@session)['pets'].should include('dog', 'cat', 'hamster')
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.check('does not exist') }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end

data/test_app/session/choose_spec.rb

@@ -0,0 +1,26 @@
+shared_examples_for "choose" do
+
+  describe "#choose" do
+    before do
+      @session.visit('/form')
+    end
+
+    it "should choose a radio button by id" do
+      @session.choose("gender_male")
+      @session.click_button('awesome')
+      extract_results(@session)['gender'].should == 'male'
+    end
+
+    it "should choose a radio button by label" do
+      @session.choose("Both")
+      @session.click_button('awesome')
+      extract_results(@session)['gender'].should == 'both'
+    end
+
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running { @session.choose('does not exist') }.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+  end
+end