Contents

---
title: Ferrum (CDP)
---

# Ferrum (Chrome DevTools Protocol)

Google Chrome can be automated using
[Ferrum](https://github.com/rubycdp/ferrum).

When Ferrum is in use, a Google Chrome process is accessible within jobs like
so:

```ruby
class DummyWorker < Wayfarer::Worker
  route.to :index

  def index
    browser # => #<Ferrum::Browser ...>
  end
end
```

## Configuring Ferrum

=== "Runtime"

    ```ruby
    Wayfarer.config.network.agent = :ferrum
    Wayfarer.config.ferrum.options = { headless: false, url: "http://chrome:3000" }
    ```

=== "Environment variables"

    ```
    WAYFARER_AGENT=ferrum
    WAYFARER_FERRUM_OPTIONS=headless:false,url:http://chrome:3000
    ```

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
wayfarer-0.4.1	docs/guides/browser_automation/ferrum.md