nimboids-capybara 1.1.2

data/lib/capybara/spec/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/lib/capybara/spec/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/lib/capybara/spec/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/lib/capybara/spec/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

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

@@ -0,0 +1,304 @@
+shared_examples_for "click_button" do
+  describe '#click_button' do
+    before do
+      @session.visit('/form')
+    end
+
+    context "with multiple values with the same name" do
+      it "should use the latest given value" do
+        @session.check('Terms of Use')
+        @session.click_button('awesome')
+        extract_results(@session)['terms_of_use'].should == '1'
+      end
+    end
+
+    context "with a form that has a relative url as an action" do
+      it "should post to the correct url" do
+        @session.click_button('Relative Action')
+        @session.current_path.should == '/relative'
+        extract_results(@session)['relative'].should == 'Relative Action'
+      end
+    end
+
+    context "with a form that has no action specified" do
+      it "should post to the correct url" do
+        @session.click_button('No Action')
+        @session.current_path.should == '/form'
+        extract_results(@session)['no_action'].should == 'No Action'
+      end
+    end
+    
+    context "with value given on a submit button" do
+      context "on a form with HTML5 fields" do
+        before do
+          @session.click_button('html5_submit')
+          @results = extract_results(@session)
+        end
+
+        it "should serialise and submit search fields" do
+          @results['html5_search'].should == 'what are you looking for'
+        end
+
+        it "should serialise and submit email fields" do
+          @results['html5_email'].should == 'person@email.com'
+        end
+
+        it "should serialise and submit url fields" do
+          @results['html5_url'].should == 'http://www.example.com'
+        end
+
+        it "should serialise and submit tel fields" do
+          @results['html5_tel'].should == '911'
+        end
+
+        it "should serialise and submit color fields" do
+          @results['html5_color'].should == '#FFFFFF'
+        end
+      end
+
+      context "on an HTML4 form" do
+        before do
+          @session.click_button('awesome')
+          @results = extract_results(@session)
+        end
+
+        it "should serialize and submit text fields" do
+          @results['first_name'].should == 'John'
+        end
+
+        it "should escape fields when submitting" do
+          @results['phone'].should == '+1 555 7021'
+        end
+
+        it "should serialize and submit password fields" do
+          @results['password'].should == 'seeekrit'
+        end
+
+        it "should serialize and submit hidden fields" do
+          @results['token'].should == '12345'
+        end
+
+        it "should not serialize fields from other forms" do
+          @results['middle_name'].should be_nil
+        end
+
+        it "should submit the button that was clicked, but not other buttons" do
+          @results['awesome'].should == 'awesome'
+          @results['crappy'].should be_nil
+        end
+
+        it "should serialize radio buttons" do
+          @results['gender'].should == 'female'
+        end
+
+        it "should serialize check boxes" do
+          @results['pets'].should include('dog', 'hamster')
+          @results['pets'].should_not include('cat')
+        end
+
+        it "should serialize text areas" do
+          @results['description'].should == 'Descriptive text goes here'
+        end
+
+        it "should serialize select tag with values" do
+          @results['locale'].should == 'en'
+        end
+
+        it "should serialize select tag without values" do
+          @results['region'].should == 'Norway'
+        end
+
+        it "should serialize first option for select tag with no selection" do
+          @results['city'].should == 'London'
+        end
+
+        it "should not serialize a select tag without options" do
+          @results['tendency'].should be_nil
+        end
+
+        it "should not submit disabled fields" do
+          @results['disabled_text_field'].should be_nil
+          @results['disabled_textarea'].should be_nil
+          @results['disabled_checkbox'].should be_nil
+          @results['disabled_radio'].should be_nil
+          @results['disabled_select'].should be_nil
+          @results['disabled_file'].should be_nil
+        end
+      end
+    end
+
+    context "with id given on a submit button" do
+      it "should submit the associated form" do
+        @session.click_button('awe123')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('Go')
+        @session.body.should include('You landed')
+      end
+    end
+    
+    context "with title given on a submit button" do
+      it "should submit the associated form" do
+        @session.click_button('What an Awesome Button')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('What an Awesome')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+    end
+
+    context "with alt given on an image button" do
+      it "should submit the associated form" do
+        @session.click_button('oh hai thar')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('hai')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+    end
+
+    context "with value given on an image button" do
+      it "should submit the associated form" do
+        @session.click_button('okay')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('kay')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+    end
+
+    context "with id given on an image button" do
+      it "should submit the associated form" do
+        @session.click_button('okay556')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+    end
+
+    context "with title given on an image button" do
+      it "should submit the associated form" do
+        @session.click_button('Okay 556 Image')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('Okay 556')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+    end
+
+    context "with text given on a button defined by <button> tag" do
+      it "should submit the associated form" do
+        @session.click_button('Click me')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('Click')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_button('Just an input')
+        extract_results(@session)['button'].should == 'button_second'
+      end
+    end
+
+   context "with id given on a button defined by <button> tag" do
+      it "should submit the associated form" do
+        @session.click_button('click_me_123')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should serialize and send GET forms" do
+        @session.visit('/form')
+        @session.click_button('med')
+        @results = extract_results(@session)
+        @results['middle_name'].should == 'Darren'
+        @results['foo'].should be_nil
+      end
+    end
+
+   context "with value given on a button defined by <button> tag" do
+      it "should submit the associated form" do
+        @session.click_button('click_me')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('ck_me')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should prefer exact matches over partial matches" do
+        @session.click_button('Just a button')
+        extract_results(@session)['button'].should == 'Just a button'
+      end
+    end
+
+    context "with title given on a button defined by <button> tag" do
+      it "should submit the associated form" do
+        @session.click_button('Click Title button')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+
+      it "should work with partial matches" do
+        @session.click_button('Click Title')
+        extract_results(@session)['first_name'].should == 'John'
+      end
+    end
+    context "with a locator that doesn't exist" do
+      it "should raise an error" do
+        running do
+          @session.click_button('does not exist')
+        end.should raise_error(Capybara::ElementNotFound)
+      end
+    end
+
+    it "should serialize and send valueless buttons that were clicked" do
+      @session.click_button('No Value!')
+      @results = extract_results(@session)
+      @results['no_value'].should_not be_nil
+    end
+    
+    it "should not send image buttons that were not clicked" do
+      @session.click_button('Click me!')
+      @results = extract_results(@session)
+      @results['okay'].should be_nil
+    end
+
+    it "should serialize and send GET forms" do
+      @session.visit('/form')
+      @session.click_button('med')
+      @results = extract_results(@session)
+      @results['middle_name'].should == 'Darren'
+      @results['foo'].should be_nil
+    end
+
+    it "should follow redirects" do
+      @session.click_button('Go FAR')
+      @session.current_url.should match(%r{/landed$})
+      @session.body.should include('You landed')
+    end
+
+    it "should post pack to the same URL when no action given" do
+      @session.visit('/postback')
+      @session.click_button('With no action')
+      @session.body.should include('Postback')
+    end
+
+    it "should post pack to the same URL when blank action given" do
+      @session.visit('/postback')
+      @session.click_button('With blank action')
+      @session.body.should include('Postback')
+    end
+  end
+
+end