Enum Error 

#[non_exhaustive]
pub enum Error {
    Io(Error),
    Disabled,
    MissingHostname,
    UnsupportedScheme(String),
    Connect(Error),
    BuildRequest(Error),
    ProtocolHeader(InvalidHeaderValue),
    WebSocketConnect(Error),
    ConnectRejected(ConnectError),
    Accept(Error),
}

Errors specific to the WebSocket fallback backend.

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.

Io(Error)

The TCP socket failed to bind or connect. Not accept: a failed accept(2) is the listener’s own to classify and retry (see crate::accept).

Disabled

WebSocket fallback was turned off via Client::enabled.

MissingHostname

The URL had no host to dial.

UnsupportedScheme(String)

The URL scheme can’t carry WebSocket. Only http, https, ws, and wss work.

Connect(Error)

The qmux handshake failed while dialing, including a non-101 upgrade response from the server.

BuildRequest(Error)

The URL couldn’t be turned into a valid WebSocket handshake request.

ProtocolHeader(InvalidHeaderValue)

An ALPN contained bytes that aren’t legal in the Sec-WebSocket-Protocol header.

WebSocketConnect(Error)

The TCP/TLS connection or the WebSocket upgrade itself failed.

ConnectRejected(ConnectError)

The server refused the connection outright, so retrying won’t help.

Accept(Error)

The qmux handshake failed while accepting an incoming connection.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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<ConnectError> for Error

fn from(source: ConnectError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature websocket only.

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.