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.
Installation
Setup
Configuring akephalos is as simple as requiring it and setting Capybara's javascript driver:
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:
Configuration
There are now a few configuration options available through Capybara's new
register_driver
API.
Using a different browser
HtmlUnit supports a few browser implementations, and you can choose which browser you would like to use through Akephalos. By default, Akephalos uses Firefox 3.6.
Ignoring javascript errors
By default HtmlUnit (and Akephalos) will raise an exception when an error is encountered in javascript files. This is generally desireable, except that certain libraries aren't supported by HtmlUnit. If possible, it's best to keep the default behavior, and use Filters (see below) to mock offending libraries. If needed, however, you can configure Akephalos to ignore javascript errors.
More
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.
Resources
- API Documentation
- Source code and issues are hosted on github.