Capybara - Cheat Sheet

capybara_cheat_sheet.md

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