Use PhantomJS instead of Chrome, still document Chrome usage though

Author: eliotsykes

Gemfile

@@ -14,7 +14,7 @@ gem 'uglifier', '>= 1.3.0'
 group :development, :test do
   gem 'byebug' # Call 'byebug' in code to stop execution and get a debugger console
   gem 'capybara'
-  gem 'chromedriver-helper' # used by JavaScript-dependent feature specs (`js: true`)
+  # gem 'chromedriver-helper' # helps with using Chrome in feature specs
   gem 'factory_girl_rails', '~> 4.5'
   gem 'pry'
   gem 'pry-rails'
@@ -31,6 +31,7 @@ end
 group :test do
   gem 'database_cleaner'
   gem 'email_spec'
+  gem 'poltergeist' # helps with using PhantomJS headless browser in feature specs
   gem 'shoulda-matchers', require: false
   gem 'vcr'
   gem 'webmock'

Gemfile.lock

@@ -36,7 +36,7 @@ GEM
       minitest (~> 5.1)
       thread_safe (~> 0.3, >= 0.3.4)
       tzinfo (~> 1.1)
-    addressable (2.3.6)
+    addressable (2.3.8)
     arel (6.0.0)
     bcrypt (3.1.9)
     binding_of_caller (0.7.2)
@@ -54,9 +54,7 @@ GEM
       xpath (~> 2.0)
     childprocess (0.5.5)
       ffi (~> 1.0, >= 1.0.11)
-    chromedriver-helper (0.0.8)
-      nokogiri (~> 1.6)
-      version_sorter (~> 1.1)
+    cliver (0.3.2)
     coderay (1.1.0)
     coffee-rails (4.1.0)
       coffee-script (>= 2.2.0)
@@ -128,6 +126,11 @@ GEM
     nokogiri (1.6.6.2)
       mini_portile (~> 0.6.0)
     orm_adapter (0.5.0)
+    poltergeist (1.6.0)
+      capybara (~> 2.1)
+      cliver (~> 0.3.1)
+      multi_json (~> 1.0)
+      websocket-driver (>= 0.2.0)
     pry (0.10.1)
       coderay (~> 1.1.0)
       method_source (~> 0.8.1)
@@ -140,7 +143,7 @@ GEM
     pry-stack_explorer (0.4.9.1)
       binding_of_caller (>= 0.7)
       pry (>= 0.9.11)
-    puffing-billy (0.5.0)
+    puffing-billy (0.5.1)
       addressable
       em-http-request (~> 1.1.0)
       em-synchrony
@@ -235,7 +238,6 @@ GEM
       execjs (>= 0.3.0)
       json (>= 1.8.0)
     vcr (2.9.3)
-    version_sorter (1.1.1)
     warden (1.2.3)
       rack (>= 1.0)
     web-console (2.0.0)
@@ -247,6 +249,9 @@ GEM
       addressable (>= 2.3.6)
       crack (>= 0.3.2)
     websocket (1.2.1)
+    websocket-driver (0.5.4)
+      websocket-extensions (>= 0.1.0)
+    websocket-extensions (0.1.2)
     xpath (2.0.0)
       nokogiri (~> 1.3)
 
@@ -256,14 +261,14 @@ PLATFORMS
 DEPENDENCIES
   byebug
   capybara
-  chromedriver-helper
   coffee-rails (~> 4.1.0)
   database_cleaner
   devise
   email_spec
   factory_girl_rails (~> 4.5)
   jquery-rails
   nokogiri
+  poltergeist
   pry
   pry-rails
   pry-rescue

spec/support/capybara.rb

@@ -2,14 +2,12 @@
 
 # 0. Check spec/support dir is auto-required in spec/rails_helper.rb.
 #
-# 1. Add capybara, selenium-webdriver, and chromedriver-helper to Gemfile:
+# 1. Add these to your Gemfile:
 #
 # group :development, :test do
 #  gem 'capybara'
-#  # selenium-webdriver & chromedriver-helper used by
-#  # JavaScript-dependent feature specs (`js: true`):
-#  gem 'selenium-webdriver'
-#  gem 'chromedriver-helper'
+#  gem 'selenium-webdriver' # For Firefox
+#  # gem 'chromedriver-helper' # Install to use Chrome in feature specs
 # end
 #
 # 2. Create a file like this one you're reading in spec/support/capybara.rb:

spec/support/capybara_driver_resolver.rb

@@ -4,15 +4,14 @@
 # with descriptive names related to the underlying browser's HTML5 support.
 module CapybaraDriverResolver
 
-  # At time of writing: These drivers wrap chrome or phantomjs and they both support
+  # At time of writing: These drivers wrap phantomjs or chrome and they both support
   # native date inputs.
-  WITH_NATIVE_DATE_INPUT = [:selenium_chrome_billy, :poltergeist_billy, :poltergeist]
+  WITH_NATIVE_DATE_INPUT = [:poltergeist_billy, :poltergeist, :selenium_chrome_billy]
 
   # At time of writing: These drivers wrap Firefox browsers that don't support native
   # date inputs.
   WITHOUT_NATIVE_DATE_INPUT = [:selenium_billy, :selenium]
 
-
   def driver_with(options)
 
     potential_drivers = options[:native_date_input] ? WITH_NATIVE_DATE_INPUT : WITHOUT_NATIVE_DATE_INPUT

spec/support/puffing_billy.rb

@@ -37,18 +37,9 @@
 
 # 5. Uncomment the *_billy driver for your desired browser:
 Capybara.javascript_driver = :selenium_billy # Uses Firefox
+# Capybara.javascript_driver = :selenium_chrome_billy
 # Capybara.javascript_driver = :webkit_billy
 # Capybara.javascript_driver = :poltergeist_billy
-Capybara.register_driver :selenium_chrome_billy do |app|
-  Capybara::Selenium::Driver.new(
-    app, browser: :chrome,
-    switches: [
-        "--proxy-server=#{Billy.proxy.host}:#{Billy.proxy.port}"
-        # "--ignore-certificate-errors" # May be needed in future
-      ]
-  )
-end
-# Capybara.javascript_driver = :selenium_chrome_billy
 
 # 6. Start using Puffing Billy. See spec/features/share_page_spec.rb for an example,
 #    and find your cached responses in spec/support/http_cache/billy