teamcapybara--capybara/lib/capybara/spec/session/selectors_spec.rb

Capybara::SpecHelper.spec Capybara::Selector do
  before do
    @session.visit('/form')
  end

  describe ":label selector" do
    it "finds a label by text" do
      expect(@session.find(:label, 'Customer Name').text).to eq 'Customer Name'
    end

    it "finds a label by for attribute string" do
      expect(@session.find(:label, for: 'form_other_title')['for']).to eq 'form_other_title'
    end

    it "finds a label from nested input using :for filter" do
      input = @session.find(:id, 'nested_label')
      expect(@session.find(:label, for: input).text).to eq 'Nested Label'
    end

    it "finds the label for an non-nested element when using :for filter" do
      select = @session.find(:id, 'form_other_title')
      expect(@session.find(:label, for: select)['for']).to eq 'form_other_title'
    end

    context "with exact option" do
      it "matches substrings" do
        expect(@session.find(:label, 'Customer Na', exact: false).text).to eq 'Customer Name'
      end

      it "doesn't match substrings" do
        expect { @session.find(:label, 'Customer Na', exact: true) }.to raise_error(Capybara::ElementNotFound)
      end
    end
  end

  describe "locate_field selectors" do
    it "can find specifically by id" do
      expect(@session.find(:field, id: 'customer_email').value).to eq "ben@ben.com"
    end

    it "can find specifically by name" do
      expect(@session.find(:field, name: 'form[other_title]')['id']).to eq "form_other_title"
    end

    it "can find specifically by placeholder" do
      expect(@session.find(:field, placeholder: 'FirstName')['id']).to eq "form_first_name"
    end
  end
end