In addition to these specific assertions, you also have easy access to various collections that the regular test/unit assertions can be used against. These collections are:
-
assigns: Instance variables assigned in the action that are available for the view.
-
session: Objects being saved in the session.
-
flash: The flash objects currently in the session.
-
cookies: Cookies being sent to the user on this request.
These collections can be used just like any other hash:
assert_not_nil assigns(:person) # makes sure that a @person instance variable was set assert_equal "Dave", cookies[:name] # makes sure that a cookie called :name was set as "Dave" assert flash.empty? # makes sure that there's nothing in the flash
For historic reasons, the assigns hash uses string-based keys. So assigns won’t work, but assigns will. To appease our yearning for symbols, though, an alternative accessor has been deviced using a method call instead of index referencing. So assigns(:person) will work just like assigns, but again, assigns will not work.
On top of the collections, you have the complete url that a given action redirected to available in redirect_to_url.
For redirects within the same controller, you can even call follow_redirect and the redirect will be followed, triggering another action call which can then be asserted against.
Manipulating the request collections
The collections described above link to the response, so you can test if what the actions were expected to do happened. But sometimes you also want to manipulate these collections in the incoming request. This is really only relevant for sessions and cookies, though. For sessions, you just do:
@request.session[:key] = "value"
For cookies, you need to manually create the cookie, like this:
@request.cookies["key"] = CGI::Cookie.new("key", "value")
Testing named routes
If you’re using named routes, they can be easily tested using the original named routes methods straight in the test case. Example:
assert_redirected_to page_url(:title => 'foo')
- MODULE ActionController::Assertions::DomAssertions
- MODULE ActionController::Assertions::ModelAssertions
- MODULE ActionController::Assertions::ResponseAssertions
- MODULE ActionController::Assertions::RoutingAssertions
- MODULE ActionController::Assertions::SelectorAssertions
- MODULE ActionController::Assertions::TagAssertions
- ActionController::Assertions::ResponseAssertions
- ActionController::Assertions::SelectorAssertions
- ActionController::Assertions::RoutingAssertions
- ActionController::Assertions::TagAssertions
- ActionController::Assertions::DomAssertions
- ActionController::Assertions::ModelAssertions
NO_STRIP | = | %w{pre script style textarea} |
Source: show
# File rails/actionpack/lib/action_controller/assertions.rb, line 47 def self.included(klass) klass.class_eval do include ActionController::Assertions::ResponseAssertions include ActionController::Assertions::SelectorAssertions include ActionController::Assertions::RoutingAssertions include ActionController::Assertions::TagAssertions include ActionController::Assertions::DomAssertions include ActionController::Assertions::ModelAssertions include ActionController::Assertions::DeprecatedAssertions end end
Source: show
# File rails/actionpack/lib/action_controller/assertions.rb, line 59 def clean_backtrace(&block) yield rescue Test::Unit::AssertionFailedError => e path = File.expand_path(__FILE__) raise Test::Unit::AssertionFailedError, e.message, e.backtrace.reject { |line| File.expand_path(line) =~ %r#{path}/ } end