capybara 3.32.2

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

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#body' do
+  it 'should return the unmodified page body' do
+    @session.visit('/')
+    expect(@session).to have_content('Hello world!') # wait for content to appear if visit is async
+    expect(@session.body).to include('Hello world!')
+  end
+
+  context 'encoding of response between ascii and utf8' do
+    it 'should be valid with html entities' do
+      @session.visit('/with_html_entities')
+      expect(@session).to have_content('Encoding') # wait for content to appear if visit is async
+      expect { @session.body.encode!('UTF-8') }.not_to raise_error
+    end
+
+    it 'should be valid without html entities' do
+      @session.visit('/with_html')
+      expect(@session).to have_content('This is a test') # wait for content to appear if visit is async
+      expect { @session.body.encode!('UTF-8') }.not_to raise_error
+    end
+  end
+end

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

@@ -0,0 +1,235 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#check' do
+  before do
+    @session.visit('/form')
+  end
+
+  describe "'checked' attribute" do
+    it 'should be true if checked' do
+      @session.check('Terms of Use')
+      expect(@session.find(:xpath, "//input[@id='form_terms_of_use']")['checked']).to be_truthy
+    end
+
+    it 'should be false if unchecked' do
+      expect(@session.find(:xpath, "//input[@id='form_terms_of_use']")['checked']).to be_falsey
+    end
+  end
+
+  it 'should trigger associated events', requires: [:js] do
+    @session.visit('/with_js')
+    @session.check('checkbox_with_event')
+    expect(@session).to have_css('#checkbox_event_triggered')
+  end
+
+  describe 'checking' do
+    it 'should not change an already checked checkbox' do
+      expect(@session.find(:xpath, "//input[@id='form_pets_dog']")).to be_checked
+      @session.check('form_pets_dog')
+      expect(@session.find(:xpath, "//input[@id='form_pets_dog']")).to be_checked
+    end
+
+    it 'should check an unchecked checkbox' do
+      expect(@session.find(:xpath, "//input[@id='form_pets_cat']")).not_to be_checked
+      @session.check('form_pets_cat')
+      expect(@session.find(:xpath, "//input[@id='form_pets_cat']")).to be_checked
+    end
+  end
+
+  describe 'unchecking' do
+    it 'should not change an already unchecked checkbox' do
+      expect(@session.find(:xpath, "//input[@id='form_pets_cat']")).not_to be_checked
+      @session.uncheck('form_pets_cat')
+      expect(@session.find(:xpath, "//input[@id='form_pets_cat']")).not_to be_checked
+    end
+
+    it 'should uncheck a checked checkbox' do
+      expect(@session.find(:xpath, "//input[@id='form_pets_dog']")).to be_checked
+      @session.uncheck('form_pets_dog')
+      expect(@session.find(:xpath, "//input[@id='form_pets_dog']")).not_to be_checked
+    end
+  end
+
+  it 'should check a checkbox by id' do
+    @session.check('form_pets_cat')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog', 'cat', 'hamster')
+  end
+
+  it 'should check a checkbox by label' do
+    @session.check('Cat')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog', 'cat', 'hamster')
+  end
+
+  it 'should work without a locator string' do
+    @session.check(id: 'form_pets_cat')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog', 'cat', 'hamster')
+  end
+
+  it 'should be able to check itself if no locator specified' do
+    cb = @session.find(:id, 'form_pets_cat')
+    cb.check
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog', 'cat', 'hamster')
+  end
+
+  it 'casts to string' do
+    @session.check(:form_pets_cat)
+    @session.click_button('awesome')
+    expect(extract_results(@session)['pets']).to include('dog', 'cat', 'hamster')
+  end
+
+  context "with a locator that doesn't exist" do
+    it 'should raise an error' do
+      msg = /Unable to find checkbox "does not exist"/
+      expect do
+        @session.check('does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context 'with a disabled checkbox' do
+    it 'should raise an error' do
+      msg = 'Unable to find visible checkbox "Disabled Checkbox" that is not disabled'
+      expect do
+        @session.check('Disabled Checkbox')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context 'with :exact option' do
+    it 'should accept partial matches when false' do
+      @session.check('Ham', exact: false)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['pets']).to include('hamster')
+    end
+
+    it 'should not accept partial matches when true' do
+      expect do
+        @session.check('Ham', exact: true)
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with `option` option' do
+    it 'can check boxes by their value' do
+      @session.check('form[pets][]', option: 'cat')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['pets']).to include('cat')
+    end
+
+    it 'should alias `with`' do
+      @session.check('form[pets][]', with: 'cat')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['pets']).to include('cat')
+    end
+
+    it 'should raise an error if option not found' do
+      expect do
+        @session.check('form[pets][]', option: 'elephant')
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'when checkbox hidden' do
+    context 'with Capybara.automatic_label_click == true' do
+      around do |spec|
+        old_click_label, Capybara.automatic_label_click = Capybara.automatic_label_click, true
+        spec.run
+        Capybara.automatic_label_click = old_click_label
+      end
+
+      it 'should check via clicking the label with :for attribute if possible' do
+        expect(@session.find(:checkbox, 'form_cars_tesla', unchecked: true, visible: :hidden)).to be_truthy
+        @session.check('form_cars_tesla')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).to include('tesla')
+      end
+
+      it 'should check via clicking the wrapping label if possible' do
+        expect(@session.find(:checkbox, 'form_cars_mclaren', unchecked: true, visible: :hidden)).to be_truthy
+        @session.check('form_cars_mclaren')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).to include('mclaren')
+      end
+
+      it 'should check via clicking the label with :for attribute if locator nil' do
+        cb = @session.find(:checkbox, 'form_cars_tesla', unchecked: true, visible: :hidden)
+        cb.check
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).to include('tesla')
+      end
+
+      it 'should check self via clicking the wrapping label if locator nil' do
+        cb = @session.find(:checkbox, 'form_cars_mclaren', unchecked: true, visible: :hidden)
+        cb.check
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).to include('mclaren')
+      end
+
+      it 'should not click the label if unneeded' do
+        expect(@session.find(:checkbox, 'form_cars_jaguar', checked: true, visible: :hidden)).to be_truthy
+        @session.check('form_cars_jaguar')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['cars']).to include('jaguar')
+      end
+
+      it 'should raise original error when no label available' do
+        expect { @session.check('form_cars_ariel') }.to raise_error(Capybara::ElementNotFound, /Unable to find visible checkbox "form_cars_ariel"/)
+      end
+
+      it 'should raise error if not allowed to click label' do
+        expect { @session.check('form_cars_mclaren', allow_label_click: false) }.to raise_error(Capybara::ElementNotFound, /Unable to find visible checkbox "form_cars_mclaren"/)
+      end
+    end
+
+    context 'with Capybara.automatic_label_click == false' do
+      around do |spec|
+        old_label_click, Capybara.automatic_label_click = Capybara.automatic_label_click, false
+        spec.run
+        Capybara.automatic_label_click = old_label_click
+      end
+
+      it 'should raise error if checkbox not visible' do
+        expect { @session.check('form_cars_mclaren') }.to raise_error(Capybara::ElementNotFound, /Unable to find visible checkbox "form_cars_mclaren"/)
+      end
+
+      it 'should include node filter in error if verified' do
+        expect { @session.check('form_cars_maserati') }.to raise_error(Capybara::ElementNotFound, 'Unable to find visible checkbox "form_cars_maserati" that is not disabled')
+      end
+
+      context 'with allow_label_click == true' do
+        it 'should check via the label if input is hidden' do
+          expect(@session.find(:checkbox, 'form_cars_tesla', unchecked: true, visible: :hidden)).to be_truthy
+          @session.check('form_cars_tesla', allow_label_click: true)
+          @session.click_button('awesome')
+          expect(extract_results(@session)['cars']).to include('tesla')
+        end
+
+        it 'should not wait the full time if label can be clicked' do
+          expect(@session.find(:checkbox, 'form_cars_tesla', unchecked: true, visible: :hidden)).to be_truthy
+          start_time = Time.now
+          @session.check('form_cars_tesla', allow_label_click: true, wait: 10)
+          end_time = Time.now
+          expect(end_time - start_time).to be < 10
+        end
+
+        it 'should check via the label if input is moved off the left edge of the page' do
+          expect(@session.find(:checkbox, 'form_cars_pagani', unchecked: true, visible: :all)).to be_truthy
+          @session.check('form_cars_pagani', allow_label_click: true)
+          @session.click_button('awesome')
+          expect(extract_results(@session)['cars']).to include('pagani')
+        end
+
+        it 'should check via the label if input is visible but blocked by another element' do
+          expect(@session.find(:checkbox, 'form_cars_bugatti', unchecked: true, visible: :all)).to be_truthy
+          @session.check('form_cars_bugatti', allow_label_click: true)
+          @session.click_button('awesome')
+          expect(extract_results(@session)['cars']).to include('bugatti')
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,121 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#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')
+    expect(extract_results(@session)['gender']).to eq('male')
+  end
+
+  it 'should choose a radio button by label' do
+    @session.choose('Both')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['gender']).to eq('both')
+  end
+
+  it 'should work without a locator string' do
+    @session.choose(id: 'gender_male')
+    @session.click_button('awesome')
+    expect(extract_results(@session)['gender']).to eq('male')
+  end
+
+  it 'should be able to choose self when no locator string specified' do
+    rb = @session.find(:id, 'gender_male')
+    rb.choose
+    @session.click_button('awesome')
+    expect(extract_results(@session)['gender']).to eq('male')
+  end
+
+  it 'casts to string' do
+    @session.choose('Both')
+    @session.click_button(:awesome)
+    expect(extract_results(@session)['gender']).to eq('both')
+  end
+
+  context "with a locator that doesn't exist" do
+    it 'should raise an error' do
+      msg = /Unable to find radio button "does not exist"/
+      expect do
+        @session.choose('does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context 'with a disabled radio button' do
+    it 'should raise an error' do
+      expect do
+        @session.choose('Disabled Radio')
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with :exact option' do
+    it 'should accept partial matches when false' do
+      @session.choose('Mal', exact: false)
+      @session.click_button('awesome')
+      expect(extract_results(@session)['gender']).to eq('male')
+    end
+
+    it 'should not accept partial matches when true' do
+      expect do
+        @session.choose('Mal', exact: true)
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with `option` option' do
+    it 'can check radio buttons by their value' do
+      @session.choose('form[gender]', option: 'male')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['gender']).to eq('male')
+    end
+
+    it 'should alias `:with` option' do
+      @session.choose('form[gender]', with: 'male')
+      @session.click_button('awesome')
+      expect(extract_results(@session)['gender']).to eq('male')
+    end
+
+    it 'should raise an error if option not found' do
+      expect do
+        @session.choose('form[gender]', option: 'hermaphrodite')
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+
+  context 'with hidden radio buttons' do
+    context 'with Capybara.automatic_label_click == true' do
+      around do |spec|
+        old_click_label, Capybara.automatic_label_click = Capybara.automatic_label_click, true
+        spec.run
+        Capybara.automatic_label_click = old_click_label
+      end
+
+      it 'should select by clicking the label if available' do
+        @session.choose('party_democrat')
+        @session.click_button('awesome')
+        expect(extract_results(@session)['party']).to eq('democrat')
+      end
+
+      it 'should select self by clicking the label if no locator specified' do
+        cb = @session.find(:id, 'party_democrat', visible: :hidden)
+        cb.choose
+        @session.click_button('awesome')
+        expect(extract_results(@session)['party']).to eq('democrat')
+      end
+
+      it 'should raise error if not allowed to click label' do
+        expect { @session.choose('party_democrat', allow_label_click: false) }.to raise_error(Capybara::ElementNotFound, /Unable to find visible radio button "party_democrat"/)
+      end
+    end
+  end
+
+  it 'should return the chosen radio button' do
+    el = @session.find(:radio_button, 'gender_male')
+    expect(@session.choose('gender_male')).to eq el
+  end
+end

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

@@ -0,0 +1,506 @@
+# frozen_string_literal: true
+
+Capybara::SpecHelper.spec '#click_button' do
+  before do
+    @session.visit('/form')
+  end
+
+  it 'should wait for asynchronous load', requires: [:js] do
+    @session.visit('/with_js')
+    @session.using_wait_time(1.5) do
+      @session.click_link('Click me')
+      @session.click_button('New Here')
+    end
+  end
+
+  it 'casts to string' do
+    @session.click_button(:'Relative Action')
+    expect(extract_results(@session)['relative']).to eq('Relative Action')
+    expect(@session.current_path).to eq('/relative')
+  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')
+      expect(extract_results(@session)['terms_of_use']).to eq('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')
+      expect(extract_results(@session)['relative']).to eq('Relative Action')
+      expect(@session.current_path).to eq('/relative')
+    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')
+      expect(extract_results(@session)['no_action']).to eq('No Action')
+      expect(@session.current_path).to eq('/form')
+    end
+  end
+
+  context 'with value given on a submit button' do
+    context 'on a form with HTML5 fields' do
+      let(:results) { extract_results(@session) }
+
+      before do
+        @session.click_button('html5_submit')
+      end
+
+      it 'should serialise and submit search fields' do
+        expect(results['html5_search']).to eq('what are you looking for')
+      end
+
+      it 'should serialise and submit email fields' do
+        expect(results['html5_email']).to eq('person@email.com')
+      end
+
+      it 'should serialise and submit url fields' do
+        expect(results['html5_url']).to eq('http://www.example.com')
+      end
+
+      it 'should serialise and submit tel fields' do
+        expect(results['html5_tel']).to eq('911')
+      end
+
+      it 'should serialise and submit color fields' do
+        expect(results['html5_color'].upcase).to eq('#FFFFFF')
+      end
+    end
+
+    context 'on an HTML4 form' do
+      let(:results) { extract_results(@session) }
+
+      before do
+        @session.click_button('awesome')
+      end
+
+      it 'should serialize and submit text fields' do
+        expect(results['first_name']).to eq('John')
+      end
+
+      it 'should escape fields when submitting' do
+        expect(results['phone']).to eq('+1 555 7021')
+      end
+
+      it 'should serialize and submit password fields' do
+        expect(results['password']).to eq('seeekrit')
+      end
+
+      it 'should serialize and submit hidden fields' do
+        expect(results['token']).to eq('12345')
+      end
+
+      it 'should not serialize fields from other forms' do
+        expect(results['middle_name']).to be_nil
+      end
+
+      it 'should submit the button that was clicked, but not other buttons' do
+        expect(results['awesome']).to eq('awesome')
+        expect(results['crappy']).to be_nil
+      end
+
+      it 'should serialize radio buttons' do
+        expect(results['gender']).to eq('female')
+      end
+
+      it "should default radio value to 'on' if none specified" do
+        expect(results['valueless_radio']).to eq('on')
+      end
+
+      it 'should serialize check boxes' do
+        expect(results['pets']).to include('dog', 'hamster')
+        expect(results['pets']).not_to include('cat')
+      end
+
+      it "should default checkbox value to 'on' if none specififed" do
+        expect(results['valueless_checkbox']).to eq('on')
+      end
+
+      it 'should serialize text areas' do
+        expect(results['description']).to eq('Descriptive text goes here')
+      end
+
+      it 'should serialize select tag with values' do
+        expect(results['locale']).to eq('en')
+      end
+
+      it 'should serialize select tag without values' do
+        expect(results['region']).to eq('Norway')
+      end
+
+      it 'should serialize first option for select tag with no selection' do
+        expect(results['city']).to eq('London')
+      end
+
+      it 'should not serialize a select tag without options' do
+        expect(results['tendency']).to be_nil
+      end
+
+      it 'should convert lf to cr/lf in submitted textareas' do
+        expect(results['newline']).to eq("\r\nNew line after and before textarea tag\r\n")
+      end
+
+      it 'should not submit disabled fields' do
+        expect(results['disabled_text_field']).to be_nil
+        expect(results['disabled_textarea']).to be_nil
+        expect(results['disabled_checkbox']).to be_nil
+        expect(results['disabled_radio']).to be_nil
+        expect(results['disabled_select']).to be_nil
+        expect(results['disabled_file']).to be_nil
+      end
+    end
+  end
+
+  context 'input type=submit button' do
+    it 'should submit by button id' do
+      @session.click_button('awe123')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit by specific button id' do
+      @session.click_button(id: 'awe123')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit by button title' do
+      @session.click_button('What an Awesome Button')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit by partial title', :exact_false do
+      @session.click_button('What an Awesome')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit by button name' do
+      @session.click_button('form[awesome]')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit by specific button name' do
+      @session.click_button(name: 'form[awesome]')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit by specific button name regex' do
+      @session.click_button(name: /form\[awes.*\]/)
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+  end
+
+  context 'with fields associated with the form using the form attribute', requires: [:form_attribute] do
+    let(:results) { extract_results(@session) }
+
+    before do
+      @session.click_button('submit_form1')
+    end
+
+    it 'should serialize and submit text fields' do
+      expect(results['outside_input']).to eq('outside_input')
+    end
+
+    it 'should serialize text areas' do
+      expect(results['outside_textarea']).to eq('Some text here')
+    end
+
+    it 'should serialize select tags' do
+      expect(results['outside_select']).to eq('Ruby')
+    end
+
+    it 'should not serliaze fields associated with a different form' do
+      expect(results['for_form2']).to be_nil
+    end
+  end
+
+  context 'with submit button outside the form defined by <button> tag', requires: [:form_attribute] do
+    let(:results) { extract_results(@session) }
+
+    before do
+      @session.click_button('outside_button')
+    end
+
+    it 'should submit the associated form' do
+      expect(results['which_form']).to eq('form2')
+    end
+
+    it 'should submit the button that was clicked, but not other buttons' do
+      expect(results['outside_button']).to eq('outside_button')
+      expect(results['unused']).to be_nil
+    end
+  end
+
+  context "with submit button outside the form defined by <input type='submit'> tag", requires: [:form_attribute] do
+    let(:results) { extract_results(@session) }
+
+    before do
+      @session.click_button('outside_submit')
+    end
+
+    it 'should submit the associated form' do
+      expect(results['which_form']).to eq('form1')
+    end
+
+    it 'should submit the button that was clicked, but not other buttons' do
+      expect(results['outside_submit']).to eq('outside_submit')
+      expect(results['submit_form1']).to be_nil
+    end
+  end
+
+  context 'with submit button for form1 located within form2', requires: [:form_attribute] do
+    it 'should submit the form associated with the button' do
+      @session.click_button('other_form_button')
+      expect(extract_results(@session)['which_form']).to eq('form1')
+    end
+  end
+
+  context 'with submit button not associated with any form' do
+    it 'should not error when clicked' do
+      expect { @session.click_button('no_form_button') }.not_to raise_error
+    end
+  end
+
+  context 'with alt given on an image button' do
+    it 'should submit the associated form' do
+      @session.click_button('oh hai thar')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('hai')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+  end
+
+  context 'with value given on an image button' do
+    it 'should submit the associated form' do
+      @session.click_button('okay')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('kay')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+  end
+
+  context 'with id given on an image button' do
+    it 'should submit the associated form' do
+      @session.click_button('okay556')
+      expect(extract_results(@session)['first_name']).to eq('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')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('Okay 556')
+      expect(extract_results(@session)['first_name']).to eq('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!')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('Click')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    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')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should serialize and send GET forms' do
+      @session.visit('/form')
+      @session.click_button('med')
+      results = extract_results(@session)
+      expect(results['middle_name']).to eq('Darren')
+      expect(results['foo']).to be_nil
+    end
+  end
+
+  context 'with name given on a button defined by <button> tag' do
+    it 'should submit the associated form when name is locator' do
+      @session.click_button('form[no_value]')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should submit the associated form when name is specific' do
+      @session.click_button(name: 'form[no_value]')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    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')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('ck_me')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    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')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('Click Title')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+  end
+
+  context 'with descendant image alt given on a button defined by <button> tag' do
+    it 'should submit the associated form' do
+      @session.click_button('A horse eating hay')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should work with partial matches', :exact_false do
+      @session.click_button('se eating h')
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+  end
+
+  context "with a locator that doesn't exist" do
+    it 'should raise an error' do
+      msg = /Unable to find button "does not exist"/
+      expect do
+        @session.click_button('does not exist')
+      end.to raise_error(Capybara::ElementNotFound, msg)
+    end
+  end
+
+  context 'with formaction attribute on button' do
+    it 'should submit to the formaction attribute' do
+      @session.click_button('Formaction button')
+      results = extract_results(@session)
+      expect(@session.current_path).to eq '/form'
+      expect(results['which_form']).to eq 'formaction form'
+    end
+  end
+
+  context 'with formmethod attribute on button' do
+    it 'should submit to the formethod attribute' do
+      @session.click_button('Formmethod button')
+      results = extract_results(@session)
+      expect(@session.current_path).to eq '/form/get'
+      expect(results['which_form']).to eq 'formaction form'
+    end
+  end
+
+  it 'should serialize and send valueless buttons that were clicked' do
+    @session.click_button('No Value!')
+    results = extract_results(@session)
+    expect(results['no_value']).not_to be_nil
+  end
+
+  it 'should send button in document order' do
+    @session.click_button('outside_button')
+    results = extract_results(@session)
+    expect(results.keys).to eq %w[for_form2 outside_button which_form post_count]
+  end
+
+  it 'should not send image buttons that were not clicked' do
+    @session.click_button('Click me!')
+    results = extract_results(@session)
+    expect(results['okay']).to be_nil
+  end
+
+  it 'should serialize and send GET forms' do
+    @session.visit('/form')
+    @session.click_button('med')
+    results = extract_results(@session)
+    expect(results['middle_name']).to eq('Darren')
+    expect(results['foo']).to be_nil
+  end
+
+  it 'should follow redirects' do
+    @session.click_button('Go FAR')
+    expect(@session).to have_content('You landed')
+    expect(@session.current_url).to match(%r{/landed$})
+  end
+
+  it 'should follow temporary redirects that maintain method' do
+    @session.click_button('Go 307')
+    expect(@session).to have_content('You post landed: TWTW')
+  end
+
+  it 'should follow permanent redirects that maintain method' do
+    @session.click_button('Go 308')
+    expect(@session).to have_content('You post landed: TWTW')
+  end
+
+  it 'should post pack to the same URL when no action given' do
+    @session.visit('/postback')
+    @session.click_button('With no action')
+    expect(@session).to have_content('Postback')
+  end
+
+  it 'should post pack to the same URL when blank action given' do
+    @session.visit('/postback')
+    @session.click_button('With blank action')
+    expect(@session).to have_content('Postback')
+  end
+
+  it 'ignores disabled buttons' do
+    expect do
+      @session.click_button('Disabled button')
+    end.to raise_error(Capybara::ElementNotFound)
+  end
+
+  it 'should encode complex field names, like array[][value]' do
+    @session.visit('/form')
+    @session.fill_in('address1_city', with: 'Paris')
+    @session.fill_in('address1_street', with: 'CDG')
+
+    @session.fill_in('address2_city', with: 'Mikolaiv')
+    @session.fill_in('address2_street', with: 'PGS')
+
+    @session.click_button 'awesome'
+
+    addresses = extract_results(@session)['addresses']
+    expect(addresses.size).to eq(2)
+
+    expect(addresses[0]['street']).to eq('CDG')
+    expect(addresses[0]['city']).to eq('Paris')
+    expect(addresses[0]['country']).to eq('France')
+
+    expect(addresses[1]['street']).to eq('PGS')
+    expect(addresses[1]['city']).to eq('Mikolaiv')
+    expect(addresses[1]['country']).to eq('Ukraine')
+  end
+
+  context 'with :exact option' do
+    it 'should accept partial matches when false' do
+      @session.click_button('What an Awesome', exact: false)
+      expect(extract_results(@session)['first_name']).to eq('John')
+    end
+
+    it 'should not accept partial matches when true' do
+      expect do
+        @session.click_button('What an Awesome', exact: true)
+      end.to raise_error(Capybara::ElementNotFound)
+    end
+  end
+end