Capybara Automation Skill
Core Patterns
Basic Test (RSpec)
require 'capybara/rspec'
RSpec.describe 'Login', type: :feature do
it 'logs in with valid credentials' do
visit '/login'
fill_in 'Email', with: 'user@test.com'
fill_in 'Password', with: 'password123'
click_button 'Login'
expect(page).to have_content('Dashboard')
expect(page).to have_current_path('/dashboard')
end
it 'shows error for invalid credentials' do
visit '/login'
fill_in 'Email', with: 'wrong@test.com'
fill_in 'Password', with: 'wrong'
click_button 'Login'
expect(page).to have_content('Invalid credentials')
end
end
DSL
# Navigation
visit '/path'
go_back
go_forward
# Interacting
fill_in 'Label or Name', with: 'text'
choose 'Radio Label'
check 'Checkbox Label'
uncheck 'Checkbox Label'
select 'Option', from: 'Select Label'
attach_file 'Upload', '/path/to/file'
click_button 'Submit'
click_link 'More Info'
click_on 'Button or Link'
# Finding
find('#id')
find('.class')
find('[data-testid="x"]')
find(:xpath, '//div')
all('.items').count
# Matchers
expect(page).to have_content('text')
expect(page).to have_selector('#element')
expect(page).to have_css('.class')
expect(page).to have_button('Submit')
expect(page).to have_field('Email')
expect(page).to have_link('Click Here')
expect(page).to have_current_path('/expected')
expect(page).to have_no_content('error')
Within Scope
within('#login-form') do
fill_in 'Email', with: 'user@test.com'
click_button 'Login'
end
within_table('users') do
expect(page).to have_content('Alice')
end
TestMu AI Cloud
Capybara.register_driver :lambdatest do |app|
caps = Selenium::WebDriver::Remote::Capabilities.new(
browserName: 'chrome',
'LT:Options' => {
user: ENV['LT_USERNAME'], accessKey: ENV['LT_ACCESS_KEY'],
build: 'Capybara Build', name: 'Login Test',
platform: 'Windows 11', video: true
}
)
Capybara::Selenium::Driver.new(app,
browser: :remote,
url: 'https://hub.lambdatest.com/wd/hub',
capabilities: caps)
end
Capybara.default_driver = :lambdatest
Setup: gem 'capybara' + gem 'selenium-webdriver' in Gemfile
Run: bundle exec rspec spec/features/
Cloud (TestMu AI)
For remote browser execution, see reference/cloud-integration.md and shared/testmu-cloud-reference.md.
Deep Patterns
See reference/playbook.md for production-grade patterns:
| Section |
What You Get |
| §1 Project Setup |
Gemfile, Capybara config, driver registration, LambdaTest |
| §2 Feature Specs |
Login flows, JavaScript interactions, modals, async content |
| §3 Page Objects |
SitePrism pages with elements/sections, usage in specs |
| §4 API Testing |
Request specs with auth headers, JSON assertions |
| §5 Database Cleaning |
DatabaseCleaner transaction/truncation strategies |
| §6 Matchers & Helpers |
Custom helpers, sign_in, expect_flash |
| §7 CI/CD Integration |
GitHub Actions with Postgres, Redis, Chrome |
| §8 Debugging Table |
12 common problems with causes and fixes |
| §9 Best Practices |
14-item Capybara testing checklist |
1---2name: lambdatest-capybara-skill3description: Generates Capybara E2E tests in Ruby with RSpec integration. Acceptance testing DSL for web apps. Use when user mentions "Capybara", "visit", "fill_in", "click_button", "Ruby E2E". Triggers on: "Capybara", "Ruby acceptance test", "fill_in", "click_button", "have_content".4license: MIT5---67# Capybara Automation Skill89## Core Patterns1011### Basic Test (RSpec)1213```ruby14require 'capybara/rspec'1516RSpec.describe 'Login', type: :feature do17 it 'logs in with valid credentials' do18 visit '/login'19 fill_in 'Email', with: 'user@test.com'20 fill_in 'Password', with: 'password123'21 click_button 'Login'22 expect(page).to have_content('Dashboard')23 expect(page).to have_current_path('/dashboard')24 end2526 it 'shows error for invalid credentials' do27 visit '/login'28 fill_in 'Email', with: 'wrong@test.com'29 fill_in 'Password', with: 'wrong'30 click_button 'Login'31 expect(page).to have_content('Invalid credentials')32 end33end34```3536### DSL3738```ruby39# Navigation40visit '/path'41go_back42go_forward4344# Interacting45fill_in 'Label or Name', with: 'text'46choose 'Radio Label'47check 'Checkbox Label'48uncheck 'Checkbox Label'49select 'Option', from: 'Select Label'50attach_file 'Upload', '/path/to/file'51click_button 'Submit'52click_link 'More Info'53click_on 'Button or Link'5455# Finding56find('#id')57find('.class')58find('[data-testid="x"]')59find(:xpath, '//div')60all('.items').count6162# Matchers63expect(page).to have_content('text')64expect(page).to have_selector('#element')65expect(page).to have_css('.class')66expect(page).to have_button('Submit')67expect(page).to have_field('Email')68expect(page).to have_link('Click Here')69expect(page).to have_current_path('/expected')70expect(page).to have_no_content('error')71```7273### Within Scope7475```ruby76within('#login-form') do77 fill_in 'Email', with: 'user@test.com'78 click_button 'Login'79end8081within_table('users') do82 expect(page).to have_content('Alice')83end84```8586### TestMu AI Cloud8788```ruby89Capybara.register_driver :lambdatest do |app|90 caps = Selenium::WebDriver::Remote::Capabilities.new(91 browserName: 'chrome',92 'LT:Options' => {93 user: ENV['LT_USERNAME'], accessKey: ENV['LT_ACCESS_KEY'],94 build: 'Capybara Build', name: 'Login Test',95 platform: 'Windows 11', video: true96 }97 )98 Capybara::Selenium::Driver.new(app,99 browser: :remote,100 url: 'https://hub.lambdatest.com/wd/hub',101 capabilities: caps)102end103Capybara.default_driver = :lambdatest104```105106## Setup: `gem 'capybara'` + `gem 'selenium-webdriver'` in Gemfile107## Run: `bundle exec rspec spec/features/`108109## Cloud (TestMu AI)110111For remote browser execution, see [reference/cloud-integration.md](reference/cloud-integration.md) and [shared/testmu-cloud-reference.md](../shared/testmu-cloud-reference.md).112113## Deep Patterns114115See `reference/playbook.md` for production-grade patterns:116117| Section | What You Get |118|---------|-------------|119| §1 Project Setup | Gemfile, Capybara config, driver registration, LambdaTest |120| §2 Feature Specs | Login flows, JavaScript interactions, modals, async content |121| §3 Page Objects | SitePrism pages with elements/sections, usage in specs |122| §4 API Testing | Request specs with auth headers, JSON assertions |123| §5 Database Cleaning | DatabaseCleaner transaction/truncation strategies |124| §6 Matchers & Helpers | Custom helpers, sign_in, expect_flash |125| §7 CI/CD Integration | GitHub Actions with Postgres, Redis, Chrome |126| §8 Debugging Table | 12 common problems with causes and fixes |127| §9 Best Practices | 14-item Capybara testing checklist |