Developer Tools
Capybara
Ruby acceptance-test DSL that drives web applications through interchangeable drivers.
What it is
Capybara is an MIT-licensed Ruby library and acceptance-testing DSL that simulates user interaction with web applications. It supplies finders, matchers, actions, sessions and automatic waiting while delegating actual execution to drivers such as the fast RackTest default or browser-capable Selenium. It is not itself a browser, test runner or assertion framework, and test fidelity, JavaScript support, isolation and concurrency behavior depend on the chosen driver and surrounding stack.
Key features
Navigation and actions
Visits pages, fills fields, clicks controls, attaches files and manipulates supported browser state.
Finders and matchers
Queries accessible labels, text, CSS and XPath with configurable matching behavior.
Automatic waiting
Retries eligible queries and expectations while asynchronous content settles.
Interchangeable drivers
Routes the DSL through RackTest, Selenium or compatible external drivers with different capabilities.
Strengths and trade-offs
What works well
- User-oriented DSL: Tests express visits, form actions, element queries and expectations close to browser behavior.
- Automatic synchronization: Finders and matchers wait up to configured limits for asynchronous page state.
- Driver portability: The same high-level API can run against RackTest, Selenium and compatible third-party drivers.
- Framework integration: Official guidance covers use with RSpec, Minitest and other Ruby test setups.
Where it falls short
- Default driver has no JavaScript: RackTest is fast but cannot validate client-side behavior or interact with remote applications.
- Browser tests cost more: Selenium-style drivers add browser binaries, timing variability and infrastructure overhead.
- Thread and data isolation: Transactional database strategies may not share state with a separately threaded application server.
- Ambiguous selectors can fail: Capybara intentionally raises on multiple matches unless the query is made specific.
Who it is for
Ruby teams writing acceptance or system tests for web applications with an explicitly selected driver stack.
Our verdict
Choose Capybara for readable Ruby acceptance tests, but select drivers per scenario: keep RackTest where server-rendered behavior is enough and prove critical JavaScript journeys with a maintained browser driver and deterministic data isolation.
Closest alternatives we track
Same category, ordered by verified starting price.
What we checked
- Public APIOffers a documented API you can build against.Yes
- Mobile appHas a native app for iOS or Android, not just a mobile website.No
- Open source / self-hostableSource is open and the tool can be run on your own infrastructure.Yes
- SSO (SAML)Supports SAML single sign-on on at least one plan.No
“Not checked” means exactly that — we have not verified it, and we do not guess.
Evidence and freshness
Status: Official sources reviewedReviewed: 2026-08-24
- Capybara — Project site ↗
Checked 2026-08-24 · Supports: Ruby library scope, user interaction simulation, driver abstraction, Selenium WebKit and pure-Ruby drivers, automatic synchronization, RubyGems installation
- Capybara — Source and README ↗
Checked 2026-08-24 · Supports: acceptance-test DSL, RackTest default, RackTest JavaScript and remote-app limitations, Selenium driver, RSpec and Minitest integration, waiting behavior, sessions, threading and transaction caveats, MIT license
- RubyGems — Capybara ↗
Checked 2026-08-24 · Supports: current gem releases, runtime dependencies, required Ruby version, source and documentation links, MIT license
- Capybara API documentation ↗
Checked 2026-08-24 · Supports: session API, node actions, finders, matchers, selector API, driver interfaces
Limit: Official Capybara pages, repository, gem metadata and generated API documentation were reviewed; ToolCompare did not run a Ruby suite, test RackTest or Selenium, measure wait behavior, validate database isolation, inspect third-party drivers, reproduce concurrency caveats or assess flake rates.