Struct FollowRedirects 

pub struct FollowRedirects { /* private fields */ }

Available on crate feature client only.

A ClientHandler that automatically follows HTTP redirects.

See the module-level documentation for behavior and configuration.

Implementations

impl FollowRedirects

pub fn new() -> Self

Construct a new FollowRedirects with default settings: max 10 redirects, HTTPS-to-HTTP downgrade blocked, all origins allowed.

pub fn with_max_redirects(self, max: u32) -> Self

Set the maximum number of redirects to follow before erroring with RedirectError::TooMany.

pub fn with_allow_downgrade(self, allow: bool) -> Self

Allow or block redirects from https:// to http://. Default is blocked.

pub fn with_allowed_origins<I: IntoIterator<Item = Url>>( self, origins: I, ) -> Self

Restrict redirects to the given allowlist of origins. Each Url’s origin (scheme + host + port) is added to the allowlist; the path/query/fragment of the input URLs is ignored.

When set, redirects to any other origin error with RedirectError::OriginNotAllowed. When unset (the default), all origins are permitted.

Trait Implementations

impl ClientHandler for FollowRedirects

async fn run(&self, conn: &mut Conn) -> Result<()>

Forward-pass hook, called before the network round-trip in declared order.

async fn after_response(&self, conn: &mut Conn) -> Result<()>

Reverse-pass hook, called after the network round-trip (or after a halt-skipped network call) in reverse declared order. Always runs regardless of halt status or transport error.

fn name(&self) -> Cow<'static, str>

Human-readable name for logging/debugging. Defaults to the type name.

impl Clone for FollowRedirects

fn clone(&self) -> FollowRedirects

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FollowRedirects

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FollowRedirects

fn default() -> Self

Returns the “default value” for a type.