Enum ProxyMode 

pub enum ProxyMode {
    Automatic,
    Direct,
    Explicit(String),
}

Available on crate feature proxy only.

How an HTTP client selects its proxy endpoint.

With system-proxy, resolve once with OriginProxy::resolve before building an origin-scoped client. This type itself needs only alloc.

Variants

Automatic

Read environment and native static settings. Per-scheme environment endpoints override native settings, followed by ALL_PROXY. This is the default. See OriginProxy for discovery and bypass semantics.

Direct

Connect directly, without reading proxy environment or native settings. Ignores ProxyOptions::no_proxy.

Explicit(String)

Use this endpoint instead of environment or native proxy endpoints.

Accepts http://, https://, socks4://, socks4a://, socks5://, and socks5h:// URLs, or a bare host[:port] for HTTP. Ports default to 80, 443, or 1080 respectively. IPv6 addresses require brackets. URL userinfo supports existing HTTP Basic/SOCKS5 authentication; percent-encode reserved characters. Debug output omits the URL, including credentials.

Invalid endpoints return Error::InvalidProxyUrl at construction, even when a bypass rule matches. Paths other than /, queries, fragments, whitespace, and port zero are rejected. SOCKS hostnames must be ASCII or punycode. A failed connection never falls back to another proxy or direct access. This explicit choice also applies when REQUEST_METHOD is set.

Trait Implementations

impl Clone for ProxyMode

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProxyMode

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

Formats the value using the given formatter.

impl Default for ProxyMode

fn default() -> Self

Returns the “default value” for a type.

impl Eq for ProxyMode

impl PartialEq for ProxyMode

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProxyMode