Enum BuildRequestError 

#[non_exhaustive]
pub enum BuildRequestError {
    MissingUrl,
    InvalidUrl {
        source: Box<dyn StdError + Send + Sync>,
    },
    UnsupportedScheme {
        scheme: String,
    },
    MissingHost,
    UserinfoNotAllowed,
    InvalidHeader {
        source: Box<dyn StdError + Send + Sync>,
    },
    EmptyTargets,
}

A Request could not be built.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

MissingUrl

No URL was provided to the builder.

InvalidUrl

The URL could not be parsed.

Fields

source: Box<dyn StdError + Send + Sync>

The underlying parse error.

UnsupportedScheme

The URL’s scheme is not https. This is an HTTP/3-only client; requests are never sent over cleartext or fall back to TCP.

Fields

scheme: String

The offending scheme.

MissingHost

The URL has no host.

UserinfoNotAllowed

The URL contains userinfo (user:password@host). HTTP/3 forbids userinfo in :authority (RFC 9114 §4.3.1), and sending it would leak the credentials on the wire; pass credentials in an authorization header instead.

InvalidHeader

A header name or value is invalid.

Fields

source: Box<dyn StdError + Send + Sync>

The underlying cause.

EmptyTargets

An empty target list was provided. Targets assert “resolution returned exactly this”, and an empty resolution result is an error, not a wildcard.

Trait Implementations

impl Debug for BuildRequestError

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

Formats the value using the given formatter.

impl Display for BuildRequestError

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

Formats the value using the given formatter.

impl Error for BuildRequestError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BuildRequestError> for Error

fn from(error: BuildRequestError) -> Self

An invalid request is an Error::InvalidRequest, so the convenience entry points (Client::get, Client::post) report builder failures through the same taxonomy as the rest of the request path.