Enum Error 

#[non_exhaustive]
pub enum Error {
    App {
        code: u64,
        reason: String,
    },
    Transport {
        code: u64,
        reason: String,
    },
    TimedOut,
    Reset(u64),
    Stop(u64),
    Tls(String),
    Io(String),
    Quic(String),
    NotServer,
    Web(String),
    Http3 {
        code: u64,
        reason: String,
    },
    Qlog(String),
}

Why a connection could not be set up or has ended.

One error type for the whole module: it is also what every web_transport_trait::poll operation on a Connection reports, which is how the close reason reaches moq_net::Error::from_transport.

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.

App

The application (ours or the peer’s) closed the connection.

Fields

code: u64

The application close code (a MoQ session code here).

reason: String

The UTF-8 lossy close reason.

Transport

QUIC closed the connection with a transport-level code.

Fields

code: u64

The QUIC transport error code.

reason: String

The UTF-8 lossy close reason.

TimedOut

The connection idled out or the handshake never completed.

Reset(u64)

The peer reset the stream with this code.

Stop(u64)

The peer told us to stop sending with this code.

Tls(String)

The TLS material a connection needs could not be loaded.

Io(String)

The socket died underneath the connection.

Quic(String)

The QUIC stack refused an operation. The backend’s own message, since the two describe the same failures differently.

NotServer

Accepting needs the server configuration the endpoint was built without.

Web(String)

The WebTransport (HTTP/3) layer failed: a broken handshake, or a stream that could not be framed.

Http3

HTTP/3 failed with a code of its own, one that names no WebTransport error (H3_NO_ERROR, say). Neither trait accessor reports it, because it is not a code the peer’s application chose.

Fields

code: u64

The HTTP/3 error code.

reason: String

The UTF-8 lossy close reason, empty for a stream-level code.

Qlog(String)

qlog traces were asked for and cannot be captured: the directory is missing or unwritable, or the writer thread could not be started.

Trait Implementations

impl Clone for Error

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

fn session_error(&self) -> Option<(u32, String)>

Returns the error code and reason if this was an application error.

fn stream_error(&self) -> Option<u32>

Returns the error code if this was a stream error.

impl From<ConnectionError> for Error

fn from(err: ConnectionError) -> Self

Converts to this type from the input type.