[][src]Struct reqwest::RedirectPolicy

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]

pub fn limited(max: usize) -> RedirectPolicy[src]

Create a RedirectPolicy with a maximum number of redirects.

An Error will be returned if the max is reached.

pub fn none() -> RedirectPolicy[src]

Create a RedirectPolicy that does not follow any redirect.

pub fn custom<T>(policy: T) -> RedirectPolicy where
    T: Fn(RedirectAttempt) -> RedirectAction + Send + Sync + 'static, 
[src]

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

let custom = 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()
    }
});
let client = reqwest::Client::builder()
    .redirect(custom)
    .build()?;

pub fn redirect(&self, attempt: RedirectAttempt) -> RedirectAction[src]

Apply this policy to a given [RedirectAttempt] to produce a [RedirectAction].

Note

This method can be used together with RedirectPolicy::custom() to construct one RedirectPolicy that wraps another.

Example

let custom = RedirectPolicy::custom(|attempt| {
    eprintln!("{}, Location: {:?}", attempt.status(), attempt.url());
    RedirectPolicy::default().redirect(attempt)
});

Trait Implementations

impl Default for RedirectPolicy[src]

impl Debug for RedirectPolicy[src]

Auto Trait Implementations

impl Send for RedirectPolicy

impl Unpin for RedirectPolicy

impl Sync for RedirectPolicy

impl !UnwindSafe for RedirectPolicy

impl !RefUnwindSafe for RedirectPolicy

Blanket Implementations

impl<T, U> Into<U> for T where
    U: From<T>, 
[src]

impl<T> From<T> for T[src]

impl<T, U> TryFrom<U> for T where
    U: Into<T>, 
[src]

type Error = Infallible

The type returned in the event of a conversion error.

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

impl<T> BorrowMut<T> for T where
    T: ?Sized
[src]

impl<T> Borrow<T> for T where
    T: ?Sized
[src]

impl<T> Any for T where
    T: 'static + ?Sized
[src]

impl<T, U> TryInto<U> for T where
    U: TryFrom<T>, 
[src]

type Err = <U as TryFrom<T>>::Err