Capybara cheatsheet.md

Check an element has a class

el = find('.NewTaxReturn-section-list-item-wrap:nth-child(2) a')
expect( el[:class].include?("m-disabled") ).to eq true

Navigating

visit('/projects')
visit(post_comments_path(post))

Clicking links and buttons

click_link('id-of-link')
click_link('Link Text')
click_button('Save')
click('Link Text') # Click either a link or a button
click('Button Value')

Interacting with forms

fill_in('First Name', :with => 'John')
fill_in('Password', :with => 'Seekrit')
fill_in('Description', :with => 'Really Long Text…')
choose('A Radio Button')
check('A Checkbox')
uncheck('A Checkbox')
attach_file('Image', '/path/to/image.jpg')
select('Option', :from => 'Select Box')

asserting

expect(page).to have_content('Customer testimonials') expect(page).to have_selector '.Label.s-attached'

scoping

within("//li[@id='employee']") do
  fill_in 'Name', :with => 'Jimmy'
end
within(:css, "li#employee") do
  fill_in 'Name', :with => 'Jimmy'
end
within_fieldset('Employee') do
  fill_in 'Name', :with => 'Jimmy'
end
within_table('Employee') do
  fill_in 'Name', :with => 'Jimmy'
end

=Querying= page.has_xpath?('//table/tr') page.has_css?('table tr.foo') page.has_content?('foo') page.should have_xpath('//table/tr') page.should have_css('table tr.foo') page.should have_content('foo') page.should have_no_content('foo') find_field('First Name').value find_link('Hello').visible? find_button('Send').click find('//table/tr').click locate("//*[@id='overlay'").find("//h1").click all('a').each { |a| a[:href] }

Scripting

result = page.evaluate_script('4 + 4');

Debugging

save_and_open_page

Asynchronous JavaScript

click_link('foo')
click_link('bar')
page.should have_content('baz')
page.should_not have_xpath('//a')
page.should have_no_xpath('//a')

XPath and CSS

within(:css, 'ul li') { ... }
find(:css, 'ul li').text
locate(:css, 'input#name').value
Capybara.default_selector = :css
within('ul li') { ... }
find('ul li').text
locate('input#name').value