Capybara 通过模拟真实用户交互的方式来测试你的 web 应用。它内置 Rack::Test 和 Selenium 支持，也支持其他驱动。WebKit 通过外部 gem 的形式支持。

核心优势

• 无需配置 对于 Rails 和 Rack 应用而言，开箱即用。
• 符合直觉的 API 模拟真实用户行为。
• 可替换后端 可以替换测试后端，例如从快速的 headless 模式切换到实际的浏览器，无需更改测试。
• 强力同步 你不用手动等待异步过程结束。

配置

Capybara 需要 Ruby 1.9.3+。在 Gemfile 中添加以下一行，然后运行 bundle install：

gem 'capybara'

Rails 应用可以在 helper 文件中加上这么一行：

require 'capybara/rails'

Rack 应用：

Capybara.app = MyRackApp

​

如果需要测试 javascript 或进行远程测试，还需要配置驱动。

Capybara 可以和 Cucumber、RSpec、Test::Unit、MiniTest::Spec配合使用。FIXME

Capybara 默认使用 RackTest 驱动，此外还支持 Selenium、Capybara-webkit、Poltergeist。

DSL

Capybara 的 DSL 十分易懂。我们来看几个例子吧：

访问：

visit('/projects')

点击链接或按钮：

click_link('id-of-link')

click_button('Save')

表单：

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')

XPath

page.has_selector?(:xpath, '//table/tr')

​

查找

find_field('First Name').value

find('#navigation').click_link('Home')

​

部分驱动支持执行 JavaScript：

page.execute_script("$('body').empty()")

result = page.evaluate_script('4 + 4');

​

项目主页

http://jnicklas.github.io/capybara/

https://github.com/jnicklas/capybara