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
Wayfarer.config.network.agent = :ferrum

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

5 entries across 5 versions & 1 rubygems

Version	Path
wayfarer-0.4.6	docs/guides/networking/ferrum.md
wayfarer-0.4.5	docs/guides/networking/ferrum.md
wayfarer-0.4.4	docs/guides/networking/ferrum.md
wayfarer-0.4.3	docs/guides/browser_automation/ferrum.md
wayfarer-0.4.2	docs/guides/browser_automation/ferrum.md