2.8 KiB
2.8 KiB
| title | layout |
|---|---|
| Capybara | default |
Navigating
visit articles_path
Clicking links and buttons
click 'Link Text'
click_button
click_link
Interacting with forms
attach_file 'Image', '/path/to/image.jpg'
fill_in 'First Name', with: 'John'
check 'A checkbox'
uncheck 'A checkbox'
choose 'A radio button'
select 'Option', from: 'Select box'
unselect
Limiting
within '.classname' do
click '...'
end
within_fieldset :id do ... end
Querying
Takes a CSS selector (or XPath if you're into that). Translates nicely into RSpec matchers:
page.should have_no_button("Save")
Use should have_no_* versions with RSpec matchers b/c should_not doesn't wait for a timeout from the driver
page.has_content?
page.has_css?
page.has_no_content?
page.has_no_css?
page.has_no_xpath?
page.has_xpath?
page.has_link?
page.has_no_link?
page.has_button?("Update")
page.has_no_button?
page.has_field?
page.has_no_field?
page.has_checked_field?
page.has_unchecked_field?
page.has_no_table?
page.has_table?
page.has_select?
page.has_no_select?
Finding
find_button
find_by_id
find_field
find_link
locate
Scoping
within '#delivery' do
fill_in 'Street', with: 'Hello'
end
within :xpath, '//article'
within_fieldset
within_table
within_frame
scope_to
find('#x').fill_in('Street', with: 'Hello')
# same as within
Scripting
execute_script('$("input").trigger('change')')
evaluate_script('window.ga')
Debugging
save_and_open_page
Page
page
.all('h3')
.body
.html
.source
.current_host
.current_path
.current_url
AJAX
using_wait_time(10) { ... }
Misc
drag
field_labeled
Capybara RSpec matchers
# all matchers have...
text: 'welcome'
text: /Hello/
visible: true
count: 4
between: 2..5
minimum: 2
maximum: 5
wait: 10
expect(page).to have_selector '.blank-state'
expect(page).to have_selector 'h1#hola', text: 'Welcome'
expect(page).to have_button
expect(page).to have_checked_field
expect(page).to have_css '...'
expect(page).to have_field
expect(page).to have_link 'Logout',
href: logout_path
expect(page).to have_select 'Language',
selected: 'German'
options: ['Engish', 'German']
with_options: ['Engish', 'German'] # partial match
expect(page).to have_table '#table'
expect(page).to have_text 'Hello',
type: :visible | :all
# alias: have_content
expect(page).to have_unchecked_field
expect(page).to have_xpath