Skip to content

Instantly share code, notes, and snippets.

Embed
What would you like to do?
capybara cheat sheet
=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')
=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
@pdxmike
Copy link

pdxmike commented Jan 22, 2017

This is great. Thank you!

@smoyte
Copy link

smoyte commented Feb 17, 2017

@ckib16
Copy link

ckib16 commented Feb 24, 2017

Nice @hooverlunch, thanks!

@jepjep70
Copy link

jepjep70 commented Feb 25, 2017

Guys good day. Can you help me on how can i create a test report when i am using capybara-cucumber in my automation. What gem should i need to install and how should i invoke it. Thank you in advance.

@cooljl31
Copy link

cooljl31 commented Mar 20, 2017

👍

@pmaderamitlasf1
Copy link

pmaderamitlasf1 commented May 12, 2017

I am unable to hit "enter" key , any solution?

@gustavo-freitas
Copy link

gustavo-freitas commented May 30, 2017

This is simple and great. Thanks!

@jumbosushi
Copy link

jumbosushi commented Jul 12, 2017

I'm always coming back to this. Thanks for a great list!

@ElizabethCobian
Copy link

ElizabethCobian commented Aug 24, 2017

Excellent! Thanks :)

@itumoraes
Copy link

itumoraes commented Sep 20, 2017

Awesome!

Copy link

ghost commented Oct 23, 2017

Thanks for this great gist 👍

@Pomeha
Copy link

Pomeha commented Nov 27, 2017

Great! 👍

@AndrewFReda
Copy link

AndrewFReda commented Dec 18, 2017

Awesome, thanks! (FYI, this gist was used by LaunchAcademy here)

@vishakhapanat
Copy link

vishakhapanat commented Jan 7, 2018

When i use find(<name_of_object>).click, I get following error
Unable to find css "" (Capybara::ElementNotFound)
Can someone please help?

@leylaKapi
Copy link

leylaKapi commented Mar 1, 2018

@vishakhapanat Did you find a solution for your error?

@igbanam
Copy link

igbanam commented Mar 14, 2018

To note, things like have_css, and have_xpath also have some optional arguments which help better querying. For instance have_css(".widget", maximum: 2)

@Pomeha
Copy link

Pomeha commented May 23, 2018

👍 👍 👍

@singh08avinash
Copy link

singh08avinash commented Jun 4, 2018

Hiii
I want to use xpath with select method in cucumber rails so how can i use xpath with select method?

@aashishbq
Copy link

aashishbq commented Jul 11, 2018

How do you wait for page to load in webrat?

@srghma
Copy link

srghma commented Jul 13, 2018

To match that select with label 'Country' have an option with text 'France' selected

expect(page).to have_select('Country', selected: 'France')

@philihp
Copy link

philihp commented Aug 18, 2018

👍

@glabrego
Copy link

glabrego commented Feb 27, 2019

TY

@arknamal
Copy link

arknamal commented Apr 24, 2019

Thanks a lot. Helpful

@FrozenIce0617
Copy link

FrozenIce0617 commented May 10, 2019

Amazing article!
Very helpful!

@davidlegare
Copy link

davidlegare commented Jul 26, 2019

Is this up to date in July 2019?

@Azzawie
Copy link

Azzawie commented Nov 22, 2019

👍

@maryline-saladin
Copy link

maryline-saladin commented Mar 14, 2020

Useful thanks !
Could someone give a little bit more info about tab handling ? opening new tab, switching, closing please ?
Thanks a lot !

@renanregis
Copy link

renanregis commented Apr 20, 2020

thanks!

@vidurpunj
Copy link

vidurpunj commented May 21, 2020

thanks

@NathenGD22
Copy link

NathenGD22 commented Mar 3, 2022

mmmm capy

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment