Skip to content
Headless HTMLUnit powered browser for Capybara
Find file
Pull request Compare This branch is 35 commits behind bernerdschaefer:master.
Latest commit bbc67f2 Joshua Davey and Lar Van Der Jagt committed with Sears Dev User Relax Capybara version dependency


Akephalos is a full-stack headless browser for integration testing with Capybara. It is built on top of HtmlUnit, a GUI-less browser for the Java platform, but can be run on both JRuby and MRI with no need for JRuby to be installed on the system.


gem install akephalos


Configuring akephalos is as simple as requiring it and setting Capybara's javascript driver:

require 'akephalos'
Capybara.javascript_driver = :akephalos

Basic Usage

Akephalos provides a driver for Capybara, so using Akephalos is no different than using Selenium or Rack::Test. For a full usage guide, check out Capybara's DSL documentation. It makes no assumptions about the testing framework being used, and works with RSpec, Cucumber, and Test::Unit.

Here's some sample RSpec code:

describe "Home Page" do
  before { visit "/" }
  context "searching" do
    before do
      fill_in "Search", :with => "akephalos"
      click_button "Go"
    it "returns results" { page.should have_css("#results") }
    it "includes the search term" { page.should have_content("akephalos") }


  • bin/akephalos allows you to start an interactive shell or DRb server, as well as perform other maintenance features.

  • Filters allows you to declare mock responses for external resources and services requested by the browser.


Something went wrong with that request. Please try again.