# Capybara

[Capybara](https://github.com/teamcapybara/capybara) is a test framework for web
applications which adds a nice API that also works well for web scraping.

```ruby
Wayfarer.config[:network][:agent] = :capybara
# Wayfarer.config[:capybara][:driver] = ...

class DummyJob < Wayfarer::Worker
  route.to :index

  def index
    browser # => #<Capybara::Session ...>
  end
end
```

## Example: Automating Chrome with Cuprite and Ferrum

1. Install the [Curpite](https://github.com/rubycdp/cuprite) Capybara driver:

    === "RubyGems"

        ```ruby
        gem install cuprite
        ```

    === "Gemfile"

        ```ruby
        gem "cuprite" # Gemfile
        ```

2. Configure Wayfarer to use the `:capybara` user agent and set the driver:

    === "Runtime"

        ```ruby
        Wayfarer.config[:network][:agent] = :capybara
        Wayfarer.config[:capybara][:driver] = :cuprite
        ```

    === "Environment variables"

        ```ruby
        WAYFARER_NETWORK_AGENT=capybara
        WAYFARER_CAPYBARA_DRIVER=cuprite
        ```

3. Register the driver with Capybara:

    ```ruby
    require "capybara/cuprite"

    Capybara.javascript_driver = :cuprite

    Capybara.register_driver(:cuprite) do |app|
      # Wayfarer's Ferrum or Selenium options can be passed along
      Capybara::Cuprite::Driver.new(app, Wayfarer.config[:ferrum][:options])
    end
    ```