| Class | Spec::Rails::Example::ControllerExampleGroup |
| In: |
lib/spec/rails/example/controller_example_group.rb
|
| Parent: | FunctionalExampleGroup |
Controller Examples live in $RAILS_ROOT/spec/controllers/.
Controller Examples use Spec::Rails::Example::ControllerExampleGroup, which supports running specs for Controllers in two modes, which represent the tension between the more granular testing common in TDD and the more high level testing built into rails. BDD sits somewhere in between: we want to a balance between specs that are close enough to the code to enable quick fault isolation and far enough away from the code to enable refactoring with minimal changes to the existing specs.
No dependencies on views because none are ever rendered. The benefit of this mode is that can spec the controller completely independent of the view, allowing that responsibility to be handled later, or by somebody else. Combined w/ separate view specs, this also provides better fault isolation.
To run in this mode, include the integrate_views declaration in your controller context:
describe ThingController do
integrate_views
...
In this mode, controller specs are run in the same way that rails functional tests run - one set of tests for both the controllers and the views. The benefit of this approach is that you get wider coverage from each spec. Experienced rails developers may find this an easier approach to begin with, however we encourage you to explore using the isolation mode and revel in its benefits.
Rspec on Rails will raise errors that occur in controller actions and are not rescued or handeled with rescue_from.
| controller | [R] | |
| request | [R] | |
| response | [R] |
When you don‘t pass a controller to describe, like this:
describe ThingsController do
… then you must provide a controller_name within the context of your controller specs:
describe "ThingController" do
controller_name :thing
...
Use integrate_views to instruct RSpec to render views in your controller examples in Integration mode.
describe ThingController do
integrate_views
...
See Spec::Rails::Example::ControllerExampleGroup for more information about Integration and Isolation modes.
Bypasses any error rescues defined with rescue_from. Useful in cases in which you want to specify errors coming out of actions that might be caught by a rescue_from clause that is specified separately.
Note that this will override the effect of rescue_action_in_public