Struct reqwest::RedirectPolicy
[−]
[src]
pub struct RedirectPolicy { /* fields omitted */ }
A type that controls the policy on how to handle the following of redirects.
The default value will catch redirect loops, and has a maximum of 10 redirects it will follow in a chain before returning an error.
Methods
impl RedirectPolicy
[src]
fn limited(max: usize) -> RedirectPolicy
Create a RedirectPolicy with a maximum number of redirects.
An Error
will be returned if the max is reached.
fn none() -> RedirectPolicy
Create a RedirectPolicy that does not follow any redirect.
fn custom<T>(policy: T) -> RedirectPolicy where
T: Fn(RedirectAttempt) -> RedirectAction + Send + Sync + 'static,
T: Fn(RedirectAttempt) -> RedirectAction + Send + Sync + 'static,
Create a custom RedirectPolicy using the passed function.
Note
The default RedirectPolicy handles redirect loops and a maximum loop chain, but the custom variant does not do that for you automatically. The custom policy should have some way of handling those.
Information on the next request and previous requests can be found
on the RedirectAttempt
argument passed to the closure.
Actions can be conveniently created from methods on the
RedirectAttempt
.
Example
client.redirect(RedirectPolicy::custom(|attempt| { if attempt.previous().len() > 5 { attempt.too_many_redirects() } else if attempt.url().host_str() == Some("example.domain") { // prevent redirects to 'example.domain' attempt.stop() } else { attempt.follow() } }));
Trait Implementations
impl Debug for RedirectPolicy
[src]
impl Default for RedirectPolicy
[src]
fn default() -> RedirectPolicy
Returns the "default value" for a type. Read more