public

zhengjia / capybara cheat sheet

Last active 2014-04-17

capybara cheat sheet

Download Gist
Clone this gist
Embed this gist
Link to this gist

capybara cheat sheet

File suppressed. Click to show.

      
        
          
          
            =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

          
        

    

Emerson commented 2012-03-10

Awesome, thanks for this

nickrivadeneira commented 2012-03-20

Nice...bookmarked this

s1mple commented 2012-04-19

Useful. Thanks.

vasconcelloslf commented 2012-05-02

Thanks !

mull commented 2012-05-25

Awesome, thank you.

dreki commented 2012-06-12

Excellent. Produced a PDF for this (and gave you credit in the metadata): http://cl.ly/0q1y282S3O2j110h0O2u

fguillen commented 2012-10-03

thanks!

makaroni4 commented 2012-12-02

leonardodarioperna commented 2012-12-22

click('Button Value') > click_on('Button Value')

borisreitman commented 2012-12-26

Thanks, here's bitcookie 8635

qoobaa commented 2013-01-26

using_wait_time 5 do
  # assertions
end

MilindS commented 2013-02-05

Thanks....its a quick reference i was looking for.

mobile-olx commented 2013-02-08

aisensiy commented 2013-02-22

This is great!

AlabamaMike commented 2013-02-27

Just what I was looking for ... many thanks!

afred commented 2013-03-15

+1

wiremine commented 2013-03-17

+1!

amoid125 commented 2013-03-18

is there any command for refresh button and back button on browser ????

morganick commented 2013-04-03

dsengupta commented 2013-04-12

(y) thanks

ZachBeta commented 2013-04-12

+1 for updates :-)

MissMathmagician commented 2013-04-15

thank you so much!!you made my life easier <3 <3

mariusbutuc commented 2013-04-24

bradleyd commented 2013-04-30

thanks!

jalevin commented 2013-05-21

nice!

wangzifeng commented 2013-06-03

Thanks!

abotalov commented 2013-06-04

Correct method name is click_on, not click
default_selector in Capybara 2 is :css so examples in section scoping should be updated.
Capybara 2.1 by default finds only visible elements so find_link('Hello').visible? doesn't really make sense
There's no such method as locate in Capybara
all('a').each { |a| a[:href] } is inefficient if page contains a lot of links and driver is quiet slow (like Selenium) as Capybara will make a query to driver for each invocation of #[]. Instead I advice to get array of elements' attributes using execute_script like it's shown here

zhublik commented 2013-06-06

Thanks!

fahimbpatel commented 2013-06-15

+1

HowHai commented 2013-06-20

Thank you!

heymatty commented 2013-07-27

Awesome, thanks!

arnewauters commented 2013-08-05

@zhengjia I believe click method has changed to click_on . Thanks for the sheet

DoctorRu commented 2013-08-13

Really thks!

thealtair commented 2013-08-22

Thank you!

FalloutX commented 2013-08-26

Amazing!
BTW, there is no have_selector

loed20 commented 2013-08-27

Thank you, very useful!

zeroed commented 2013-09-06

Thanks!

^_^

tomreese commented 2013-09-19

This is awesome, thanks!

tochman commented 2013-10-07

Life saver. Thx.

Dorian commented 2013-10-24

Great, thanks, this is really useful: find('form.foo .btn').click

jalcine commented 2013-11-02

@FalloutX have_selector works when you use 'expect' syntax:

expect(page).to have_selector 'foobar'

zaczheng commented 2013-11-12

within now works differently:

within("li#employee") do
fill_in 'Name', :with => 'Jimmy'
end

within(:xpath, "//li[@id='employee']") do
fill_in 'Name', :with => 'Jimmy'
end

You might want to update your gist.

https://github.com/jnicklas/capybara#scoping

TomLewis commented 2013-11-15

Very Handy, Thanks!

henrique2010 commented 2013-11-21

Hi, it is very useful. Just for "add value", in multiple select exists unselect(Option, from: select_box)

bf4 commented 2013-12-05

Anyone have an up-to-date fork?

mangantj commented 2013-12-13

If you can't find select via

select('Option', :from => 'Select Box')

do

find("#select_id").select("value")

tomaszgiba commented 2014-01-03

cool!

shekibobo commented 2014-01-03

New ability to choose option from a specific radio group (as of 2.2.0):

choose("radio_group_selector"), option: "Option 5"

cirosantilli commented 2014-02-08

I'm maintaining one that can be run and asserted on: https://github.com/cirosantilli/rails-cheat/blob/master/app/test/integration/capybara_test.rb

s01ipsist commented 2014-02-11

When debugging, I have found
page.driver.render 'tmp/page.png'
to be particularly useful to give you an idea of what Poltergeist is looking at on screen

yawo commented 2014-02-14

great !

dipak1112 commented 2014-02-24

it's really good and helpfull

smokingcat commented 2014-02-27

cool thanks!

pete2786 commented 2014-03-19

Thank you!

GraceCao commented 2014-03-27

good job, thank you

Please sign in to comment on this gist.

Something went wrong with that request. Please try again.