Ruby-on-rails – How to target localized button with RSpec and Capybara

In the end a macro was the answer I needed as apparently there is nothing native in capybara.

# spec/support/form_helpers.rb
module FormHelpers
  def submit_form
    find('input[name="commit"]').click
  end
end

This gets included in spec_helper.rb

RSpec.configure do |config|
  config.include FormHelpers, :type => :feature
  ...etc...

I used :type => :feature so it gets included only in the integration tests.

In the integration tests you can use it like this:

scenario 'pages can be created' do
  visit new_page_path
  fill_in 'page_title', with: 'A Tale of Two Cities'
  submit_form # Clicks the commit button regardless of id or text

  expect(page).to have_content 'The page was created'
  ...etc..
end

Of course submit_form can also be used inside within blocks and with :js => true.

It is stated that fill_in looks for field name, id or label text. According to ActionView::Helpers::FormHelper section of rails guides, the view code which you ask about should be translated to the following html code:

# I assume that you made a form for a @user object
<label for="user_name">
  Name
</label>
<input id="user_name" name="user[name]" type="text" />

As you see, label produced the "Name" text, which you ask for inside of your fill_in expression. But id and name properties of input field are slightly different, so you should have been using id based selector to achieve the same result:

fill_in "user_name", with: 'Example User'

So, to sum up, label field is not required, but you should watch for your html code carefully and select the appropriate parameters for fill_in expression.