Capybara register new driver for test

capybara_config.rb

# Typically this faile named capybara.rb and needed for browser configuration.
# This file related to capybara 3.22.0 and webdriver 3.8.0

require 'capybara/rspec'
require 'capybara-screenshot/rspec'
require 'webdrivers'

Capybara.register_driver :context_selenium_chrome do |app|
  chrome_args  = %w[window-size=1920,1080]
  
  # for headless can be used config file or ENV variable.
  chrome_args += %w[headless disable-gpu] if APP_CONFIG.dig('headless')

  # after gem updates chromeOptions changed to 'goog:chromeOptions' - https://github.com/elgalu/docker-selenium/issues/201
  capabilities = Selenium::WebDriver::Remote::Capabilities.chrome(
      'goog:chromeOptions': { args: chrome_args }
  )
  Capybara::Selenium::Driver.new app,
                                 browser: :chrome,
                                 desired_capabilities: capabilities
end

Capybara::Screenshot.register_driver(:context_selenium_chrome) do |driver, path|
  driver.browser.save_screenshot(path)
end

# Available drivers: :rack_test, :selenium, :selenium_chrome, :selenium_chrome_headless, :chrome

Capybara.default_driver    = :context_selenium_chrome
Capybara.javascript_driver = :context_selenium_chrome

# option to hide puma start logs
Capybara.server = :puma, { Silent: true }

2023 checking in here, here's what worked for me:

Capybara.register_driver :selenium_chrome do |app|
  options = Selenium::WebDriver::Chrome::Options.new

  %w[
    incognito
    disable-extensions
    auto-open-devtools-for-tabs
    window-size=1920,1080
  ].each { options.add_argument _1 }

  %w[
    headless
    disable-gpu
  ].each { options.add_argument _1 } if %w[1 on true].include?(ENV['HEADLESS'])

  Capybara::Selenium::Driver.new(app, browser: :chrome, options: options)
end

Capybara.default_driver = :selenium_chrome
Capybara.javascript_driver = :selenium_chrome

If you happened to encounter SeleniumHQ/selenium#2228 this will also auto open devtools for you in Chrome.