Enum TokioError 

#[non_exhaustive]
pub enum TokioError {
    Http {
        url: String,
        source: Error,
    },
    Status {
        url: String,
        status: StatusCode,
    },
    Client(Error),
    Auth(Error),
    ByteRangeOverflow {
        url: String,
        offset: u64,
        length: u64,
    },
    Stalled,
}

Available on crate feature tokio only.

Errors from the tokio IO adapter itself — distinct from crate::client::Error, the sans-IO core’s own parse/demux error type (wrapped here via TokioError::Client).

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.

Http

The underlying HTTP request failed outright (connect/timeout/TLS/ transport error) — never a non-2xx response, see Self::Status.

Fields

url: String

The request URL.

source: Error

The underlying reqwest error.

Status

The server returned a non-success HTTP status.

Fields

url: String

The request URL.

status: StatusCode

The response status.

Client(Error)

The sans-IO core rejected the fetched playlist/resource — see crate::client::Error for the underlying reason.

Auth(Error)

A 401’s WWW-Authenticate challenge could not be parsed, or no Authorization response could be computed from it (e.g. an unsupported Digest algorithm/qop) — see broadcast_auth::Error.

ByteRangeOverflow

Building the Range header for url would overflow u64 (offset + (length - 1), RFC 8216bis §4.4.4.9). In normal operation this never fires: crate::client::HlsClient’s internal resolve_byte_range already rejects any byte range whose offset + length overflows before it ever reaches this adapter (see crate::client::Error::ByteRangeOverflow) — this variant is defense-in-depth against a future/foreign caller constructing a (u64, u64) byte range directly, bypassing the sans-IO core.

Fields

url: String

The request URL the range applies to.

offset: u64

The range’s starting offset.

length: u64

The range’s length.

Stalled

The sans-IO core had nothing queued to do and the stream had not ended. In normal operation on_playlist always queues a reload (or a wait) before returning, so this signals a core bug rather than a network condition; it replaces a 10 ms defensive sleep that used to hide it.

Trait Implementations

impl Debug for TokioError

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

Formats the value using the given formatter.

impl Display for TokioError

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

Formats the value using the given formatter.

impl Error for TokioError

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

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for TokioError

fn from(source: Error) -> Self

Converts to this type from the input type.