Enum serenity::Error

#[non_exhaustive]
pub enum Error {
    Decode(&'static str, Value),
    Format(Error),
    Io(Error),
    Json(Error),
    Model(ModelError),
    ExceededLimit(String, u32),
    NotInRange(&'static str, u64, u64, u64),
    Other(&'static str),
    Url(String),
    Client(ClientError),
    Collector(CollectorError),
    Gateway(GatewayError),
    Http(Box<HttpError>),
    Tungstenite(Error),
}

A common error enum returned by most of the library’s functionality within a custom Result.

The most common error types, the ClientError and GatewayError enums, are both wrapped around this in the form of the Self::Client and Self::Gateway variants.

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.

Decode(&'static str, Value)

An error while decoding a payload.

Format(Error)

There was an error with a format.

Io(Error)

An std::io error.

Json(Error)

An error from the serde_json crate.

Model(ModelError)

An error from the model module.

ExceededLimit(String, u32)

Input exceeded a limit. Providing the input and the limit that’s not supposed to be exceeded.

This only exists for the GuildId::ban and Member::ban functions. For their cases, it’s the “reason”.

NotInRange(&'static str, u64, u64, u64)

The input is not in the specified range. Returned by GuildId::members, Guild::members and PartialGuild::members

(param_name, value, range_min, range_max)

Other(&'static str)

Some other error. This is only used for “Expected value ” errors, when a more detailed error can not be easily provided via the Error::Decode variant.

Url(String)

An error from the url crate.

Client(ClientError)

Available on crate feature client only.

A client error.

Collector(CollectorError)

Available on crate feature collector only.

A collector error.

Gateway(GatewayError)

Available on crate feature gateway only.

An error from the gateway module.

Http(Box<HttpError>)

Available on crate feature http only.

An error from the http module.

Tungstenite(Error)

Available on crate feature gateway only.

An error from the tungstenite crate.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Error for Error

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

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 Error

fn from(e: ModelError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature gateway only.

fn from(e: GatewayError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: IoError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature http only.

fn from(e: HttpError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: FormatError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature http only.

fn from(e: ReqwestError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature gateway only.

fn from(e: TungsteniteError) -> Error

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: JsonError) -> Error

Converts to this type from the input type.

impl From<InvalidHeaderValue> for Error

Available on crate feature http only.

fn from(e: InvalidHeaderValue) -> Error

Converts to this type from the input type.