class ActionController::TestCase

assert_redirected_to page_url(title: ‘foo’)
named routes’ methods straight in the test case.
If you’re using named routes, they can be easily tested using the original
## Testing named routes
cookies.clear
To clear the cookies for a test just clear the cookie collection:<br><br>cookies = “value”<br>session = “value”
do this just assign a value to the session or cookie collection:
Sometimes you need to set up the session and cookie variables for a test. To
## Manipulating session and cookie variables
then be asserted against.
and the redirect will be followed, triggering another action call which can
For redirects within the same controller, you can even call follow_redirect
redirected to available in ‘redirect_to_url`.
On top of the collections, you have the complete URL that a given action
assert flash.empty? # makes sure that there’s nothing in the flash
assert_equal “Dave”, cookies # makes sure that a cookie called :name was set as “Dave”
These collections can be used just like any other hash:
* cookies: Cookies being sent to the user on this request.
* flash: The flash objects currently in the session.
* session: Objects being saved in the session.
collections are:
collections that the regular test/unit assertions can be used against. These
In addition to these specific assertions, you also have easy access to various
## Testing controller internals
end
tests WidgetController
class SpecialEdgeCaseWidgetsControllerTest < ActionController::TestCase
class name, you can explicitly set it with ‘tests`.
from the test class name. If the controller cannot be inferred from the test
ActionController::TestCase will automatically infer the controller under test
## Controller is automatically inferred
may use this object to inspect the HTTP response in detail.
calling `post`. If the various assert methods are not sufficient, then you
last HTTP response. In the above example, `@response` becomes valid after
: An ActionDispatch::TestResponse object, representing the response of the
@response
request.
you might want to set some session properties before sending a GET
You can modify this object before sending the HTTP request. For example,
: An ActionController::TestRequest, representing the current HTTP request.
@request
: The controller instance that will be tested.
@controller
instance variables for use in the tests:
ActionController::TestCase will also automatically provide the following
## Special instance variables
end
post :create, body: json
json = {book: { title: “Love Hina” }}.to_json
def test_create
You can also send a real document in the simulated HTTP request.
end
end
assert_not_nil Book.find_by(title: “Love Hina”)
# Asserts that the controller really put the book in the database.
assert_response :found
# the created book’s URI.
# Asserts that the controller tried to redirect us to
post(:create, params: { book: { title: “Love Hina” }})
# Simulate a POST response with the given HTTP parameters.
def test_create
class BooksControllerTest < ActionController::TestCase
For example:
anything: the controller’s HTTP response, the database contents, etc.
2. Then, one asserts whether the current state is as expected. “State” can be
method to simulate an HTTP request.
1. First, one uses the ‘get`, `post`, `patch`, `put`, `delete`, or `head`
Functional tests are written as follows:
## Basic example
effective testing of controller actions including even API endpoints.
functional tests and provide lot of helpers such as `as`, `parsed_body` for
tests merely simulate a request. Besides, integration tests are as fast as
controller tests perform actual requests, whereas functional style controller
and they should only be used for backward compatibility. Integration style
New Rails applications no longer generate functional style controller tests
(use ActionDispatch::IntegrationTest).
Rails discourages the use of functional tests in favor of integration tests
## Use integration style controller tests over functional style controller tests.
to test a single controller action per test method.
Superclass for ActionController functional tests. Functional tests allow you
# Action Controller Test Case