Module | ActionController::Redirecting |
In: |
lib/action_controller/metal/redirecting.rb
|
Redirects the browser to the target specified in options. This parameter can take one of three forms:
Examples:
redirect_to :action => "show", :id => 5 redirect_to post redirect_to "http://www.rubyonrails.org" redirect_to "/images/screenshot.jpg" redirect_to articles_url redirect_to :back redirect_to proc { edit_post_url(@post) }
The redirection happens as a "302 Moved" header unless otherwise specified.
Examples:
redirect_to post_url(@post), :status => :found redirect_to :action=>'atom', :status => :moved_permanently redirect_to post_url(@post), :status => 301 redirect_to :action=>'atom', :status => 302
The status code can either be a standard HTTP Status code as an integer, or a symbol representing the downcased, underscored and symbolized description. Note that the status code must be a 3xx HTTP code, or redirection will not occur.
If you are using XHR requests other than GET or POST and redirecting after the request then some browsers will follow the redirect using the original request method. This may lead to undesirable behavior such as a double DELETE. To work around this you can return a 303 See Other status code which will be followed using a GET request.
Examples:
redirect_to posts_url, :status => :see_other redirect_to :action => 'index', :status => 303
It is also possible to assign a flash message as part of the redirection. There are two special accessors for the commonly used flash names alert and notice as well as a general purpose flash bucket.
Examples:
redirect_to post_url(@post), :alert => "Watch it, mister!" redirect_to post_url(@post), :status=> :found, :notice => "Pay attention to the road" redirect_to post_url(@post), :status => 301, :flash => { :updated_post_id => @post.id } redirect_to { :action=>'atom' }, :alert => "Something serious happened"
When using redirect_to :back, if there is no referrer, ActionController::RedirectBackError will be raised. You may specify some fallback behavior for this case by rescuing ActionController::RedirectBackError.