Accessing application session in Capybara

Accessing application session in Capybara


There are some cases when you may need to access application session in your tests:
  • User signup or registration flow is too long.
  • Application use another backend and store result into session.
In each story you must repeat the same steps. You can actually use some shared code but it does not speed-up tests anyway.Nowadays if you want to access session in cucumber/capybara acceptance test you are in trouble.Capybara’ README says:And it’s true :)


So is it actually possible to access session? Actually yes :)Instead of trying to hack capybara you may just extend your application in test environment! Just add some code that modify session according to given request parameters.If you use rack based application then your are lucky – try rack_session_access gem.If it’s another application you need implement concept yourself :)This gem should work with any rack application. We covered it with acceptance testing against:
  • rack builder application
  • sinatra application
  • rails3 application


See README for usage examples.

Rails + Rspec + Capybara example

Add to spec/spec_helper.rb:And use set_rack_session helper in acceptance test:


Enjoy faster testing!