Struct isahc::config::VersionNegotiation

pub struct VersionNegotiation { /* fields omitted */ }

A strategy for selecting what HTTP versions should be used when communicating with a server.

Methods

impl VersionNegotiation

pub const fn latest_compatible() -> Self

Always prefer the latest supported version with a preference for old versions if necessary in order to connect. This is the default.

Typically negotiation will begin with an HTTP/1.1 request, upgrading to HTTP/2 if possible, then to HTTP/3 if possible, etc.

pub const fn http10() -> Self

Connect via HTTP/1.0 and do not attempt to use a higher version.

pub const fn http11() -> Self

Connect via HTTP/1.1 and do not attempt to use a higher version.

pub const fn http2() -> Self

Connect via HTTP/2. Failure to connect will not fall back to old versions, unless HTTP/1.1 is negotiated via TLS ALPN before the session begins.

If HTTP/2 support is not compiled in, then using this strategy will always result in an error.

This strategy is often referred to as HTTP/2 with Prior Knowledge.

Trait Implementations

impl Clone for VersionNegotiation

fn clone(&self) -> VersionNegotiation

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for VersionNegotiation

fn default() -> Self

Returns the "default value" for a type.

impl Debug for VersionNegotiation

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

Formats the value using the given formatter.