Switch to chrome for Selenium tests. Done with NUBIC#328.

As noted in env.rb, Firefox will not deliver focus/blur events when in the
OS background. This means that tests that rely on the change event being fired
for text inputs, e.g., will fail if Firefox is in the background.

.gitignore

@@ -19,6 +19,7 @@ rdoc
 pkg
 Gemfile.lock
 reports
+chromedriver.log
 
 ## PROJECT::SPECIFIC
 testbed

README.md

@@ -164,4 +164,25 @@ to run the features and start writing tests!
 
 [bundler]: http://gembundler.com/
 
+## Selenium
+
+Some of Surveyor's integration tests use Selenium WebDriver and Capybara. The
+WebDriver-based tests default to running in Chrome due to an unfortunate
+[Firefox bug][FF566671]. For them to run, you'll either need:
+
+* Chrome and [chromedriver][] installed, or
+* to switch to use Firefox instead
+
+To use Firefox instead of Chrome, invoke one or more features with
+`SELENIUM_BROWSER` set in the environment:
+
+    $ SELENIUM_BROWSER=firefox bundle exec rake cucumber
+    $ SELENIUM_BROWSER=firefox bundle exec cucumber features/ajax_submissions.feature
+
+Note that when running features in Firefox, you must allow the WebDriver-driven
+Firefox to retain focus, otherwise some tests will fail.
+
+[FF566671]: https://bugzilla.mozilla.org/show_bug.cgi?id=566671
+[chromedriver]: http://code.google.com/p/selenium/wiki/ChromeDriver
+
 Copyright (c) 2008-2011 Brian Chamberlain and Mark Yoon, released under the MIT license

features/step_definitions/surveyor_steps.rb

@@ -261,7 +261,7 @@ def render_context
   if dis_or_en == 'dis'
     element['disabled'].should == 'true'
   else
-    element['disabled'].should be_nil
+    [nil, 'false'].should include(element['disabled'])
   end
 end
 

features/support/env.rb

@@ -29,11 +29,17 @@
 #
 ActionController::Base.allow_rescue = false
 
+# Use chrome for Selenium by default. This is because of Firefox's bug 566671
+# (https://bugzilla.mozilla.org/show_bug.cgi?id=566671): any test that relies on
+# blur or change events will not work when Firefox is in the background.
+ENV['SELENIUM_BROWSER'] ||= 'chrome'
+
 # Wait for AJAX requests to complete in selenium
 # n.b.: Capybara 2.0 will change the way this works.
 # http://groups.google.com/group/ruby-capybara/browse_thread/thread/6d955173ce413b0a/d0682d47a915dfbd
 Capybara.register_driver :selenium do |app|
-  Capybara::Selenium::Driver.new(app, :resynchronize => true)
+  Capybara::Selenium::Driver.new(app, :browser => ENV['SELENIUM_BROWSER'].to_sym,
+    :resynchronize => true)
 end
 
 Before do |scenario|

features/support/simultaneous_ajax.rb

@@ -67,5 +67,6 @@ def enable_ajax_call_refcount(driver)
 # Provides an alternative selenium driver with resync off and refcounting on.
 # This allows for simulation of competing AJAX requests.
 Capybara.register_driver :selenium_nowait do |app|
-  Capybara::Selenium::Driver.new(app, :resynchronize => false, :listener => AjaxRefCountListener.new)
+  Capybara::Selenium::Driver.new(app, :browser => ENV['SELENIUM_BROWSER'].to_sym,
+    :resynchronize => false, :listener => AjaxRefCountListener.new)
 end