Capybara Capybara pomaga testować aplikacje internetowe, symulując zachowanie prawdziwego użytkownika w testach integracyjnych.
Nawigacja i akcje
visit '/login'
visit articles_path
Klikanie linków i przycisków
click_on 'Submit' # Dopasowuje tekst linku lub przycisku
click_button 'Save Changes'
click_link 'Log Out'
Pola formularzy
fill_in 'Email', with: '[email protected]'
fill_in 'Password', with: 'secret'
choose 'Male' # Przycisk radiowy (Radio button)
check 'Accept Terms' # Pole wyboru (Checkbox)
uncheck 'Send Newsletter'
select 'California', from: 'State'
unselect 'Hawaii', from: 'State'
attach_file 'Avatar', '/path/to/image.png'
Zakres i kontekst (Scoping)
Ograniczenie akcji do określonego węzła DOM lub formularza:
within '.modal-dialog' do
fill_in 'Username', with: 'admin'
click_button 'Confirm'
end
within_fieldset 'Shipping Address' do
fill_in 'City', with: 'San Francisco'
end
within_table 'Orders' do
expect(page).to have_content('$99.00')
end
Dopasowania RSpec
expect(page).to have_content('Welcome Back')
expect(page).to have_current_path('/dashboard')
# Obecność elementów
expect(page).to have_selector('div.alert', text: 'Success')
expect(page).to have_css('button.primary')
expect(page).to have_xpath('//table/tr')
# Kontrolki formularzy
expect(page).to have_field('First Name', with: 'John')
expect(page).to have_checked_field('Agree to Terms')
expect(page).to have_select('Role', selected: 'Developer')
expect(page).to have_button('Submit', disabled: false)
expect(page).to have_link('Profile', href: '/users/1')
# Asercje negatywne
expect(page).to have_no_content('Error')
expect(page).not_to have_selector('.modal')
Wyszukiwarki elementów (Finders)
btn = find('button.submit')
btn.click
field = find_field('Email')
link = find_link('Home')
all('li.nav-item').each do |item|
puts item.text
end
Alerty i okna dialogowe JavaScript
# Akceptacja alertu przeglądarki
accept_alert do
click_button 'Show Alert'
end
# Akceptacja okna potwierdzenia
accept_confirm do
click_button 'Delete Account'
end
# Odrzucenie okna potwierdzenia
dismiss_confirm do
click_button 'Cancel Order'
end
Debugowanie
# Otwieranie wyrenderowanej strony HTML w przeglądarce
save_and_open_page
# Zapisywanie zrzutu ekranu
save_and_open_screenshot
# Wykonywanie kodu JavaScript
page.execute_script("$('.dropdown').show()")
result = page.evaluate_script("window.innerWidth")