RSpec x Capybara で画面のテストをしていたんだが、JavaScript を叩いてページ遷移している箇所があり、こいつのテストをするのに手間取ってしまった。曰く、

まだ完全には理解できていないがひとまず動くようになったので何をやったかをメモしておく。

環境

OS
- Ubuntu 14.04LTS
- vagrant の ubuntu-14.04-amd64 という box を使っている。
Ruby
- 2.2.3
Rails
- 4.2.4
RSpec
- 3.3.0
Capybara
- 2.5.0
Capybara-Webkit
- 1.7.1
qmake
- 4.8.6
- テストを走らせると WARNING: The next major version of capybara-webkit will require at least version 5.0 of Qt. You're using version 4.8.6. と出るんだが qt5 のインストール方法は未調査
xvfb
- 2:1.15.1-0ubuntu2.7

やったこと順

Gemfile

group :test do
  # ...
  gem "capybara-webkit"
  # ...
end

$ bundle install --path vendor/bundle --without=production --binstubs=bundle_bin

$ sudo apt-get install -y libqtwebkit-dev qt4-qmake

$ rspec

...
Capybara::Webkit::ConnectionError:
... capybara-webkit-1.7.1/bin/webkit_server failed to start.

$ vendor/bundle/ruby/2.2.0/gems/capybara-webkit-1.7.1/bin/webkit_server
webkit_server: cannot connect to X server

$ sudo apt-get install -y xvfb

$ Xvfb :1 -screen 0 1024x768x16 -nolisten inet6

$ export DISPLAY=localhost:1.0
$ rspec

$ sudo apt-get install -y xvfb

$ sudo apt-get install -y libqtwebkit-dev qt4-qmake

Gemfile

group :test do
  # ...
  gem "capybara-webkit"
  # ...
end

$ bundle install --path vendor/bundle --without=production --binstubs=bundle_bin

$ Xvfb :1 -screen 0 1024x768x16 -nolisten inet6

$ export DISPLAY=localhost:1.0
$ rspec

rspec 使うたび、あるいは開発環境起動するたびに Xvfbも立ち上げるのは面倒くさいので自動化したい。そこで、テストのはじめに別プロセスで立ち上げ、テストの終わりに killall で葬り去ることにした。

spec/rails-helper.rb に下記の通り追記

spec/rails-helper.rb

config.before :suite do
  system "Xvfb :1 -screen 0 1024x768x16 -nolisten inet6 &"
end

config.after :suite do
  system "killall Xvfb"
end

環境変数 DISPLAY は、.env ファイルに追記（多分 dotenv という gem が必要）

.env

DISPLAY="localhost:1.0"

これで、 RSpec を叩くだけでテストが動く。