@@ -58,11 +58,12 @@ In your `rails_helper.rb`:
5858``` ruby
5959require ' billy/capybara/rspec'
6060
61- # select a driver for your chosen browser environment
62- Capybara .javascript_driver = :selenium_billy # Firefox
63- # Capybara.javascript_driver = :selenium_chrome_billy # Chrome
64- # Capybara.javascript_driver = :selenium_chrome_headless_billy # Chrome (headless, recommended for CI)
65- # Capybara.javascript_driver = :apparition_billy # Apparition
61+ # Select a driver for your chosen browser environment.
62+ # The :selenium_chrome_billy and :selenium_chrome_headless_billy drivers
63+ # respect the CHROME_BIN environment variable for custom Chrome/Chromium paths.
64+ Capybara .javascript_driver = :selenium_billy # Firefox
65+ # Capybara.javascript_driver = :selenium_chrome_billy # Chrome
66+ # Capybara.javascript_driver = :selenium_chrome_headless_billy # Chrome (headless, recommended for CI)
6667```
6768
6869### Setup for Watir
@@ -72,9 +73,19 @@ In your `rails_helper.rb`:
7273``` ruby
7374require ' billy/watir/rspec'
7475
75- # select a driver for your chosen browser environment
76+ # Basic usage
7677@browser = Billy ::Browsers ::Watir .new :chrome
7778# @browser = Billy::Browsers::Watir.new :firefox
79+
80+ # CI / containerized environments (Docker, GitHub Actions)
81+ # Pass Chrome options to enable headless mode and container-safe flags.
82+ # Set CHROME_BIN if Chromium is not at the default google-chrome path.
83+ options = Selenium ::WebDriver ::Chrome ::Options .new
84+ options.add_argument(' --headless=new' )
85+ options.add_argument(' --no-sandbox' )
86+ options.add_argument(' --disable-dev-shm-usage' )
87+ options.binary = ENV [' CHROME_BIN' ] if ENV [' CHROME_BIN' ]
88+ @browser = Billy ::Browsers ::Watir .new :chrome , options: options
7889```
7990
8091### In your tests (Capybara/Watir)
0 commit comments