Enum Error 

#[non_exhaustive]
pub enum Error {
    BadEncoding,
    BodyUsed,
    Json((String, u16)),
    JsError(String),
    Http(Error),
    Infallible,
    Internal(JsValue),
    Io(Error),
    BindingError(String),
    RouteInsertError(InsertError),
    RouteNoDataError,
    RustError(String),
    SerdeJsonError(Error),
    SerdeWasmBindgenError(Error),
    StatusCode(InvalidStatusCode),
    D1(D1Error),
    Utf8Error(Utf8Error),
    TimezoneError,
    KvError(KvError),
    EmailRecipientSuppressed(String),
    EmailRecipientNotAllowed(String),
    RateLimitExceeded(String),
    DailyLimitExceeded(String),
    InternalError(String),
    UnknownJsError {
        original: JsValue,
        name: Option<String>,
        message: String,
        code: Option<String>,
        cause: Option<Box<Error>>,
    },
}

All possible Error variants that might be encountered while working with a Worker.

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.

BadEncoding

BodyUsed

Json((String, u16))

JsError(String)

Error used for strings thrown from JS

Http(Error)

Infallible

Internal(JsValue)

Error used for unknown JS values thrown from JS

Io(Error)

BindingError(String)

RouteInsertError(InsertError)

RouteNoDataError

RustError(String)

SerdeJsonError(Error)

SerdeWasmBindgenError(Error)

StatusCode(InvalidStatusCode)

D1(D1Error)

Utf8Error(Utf8Error)

TimezoneError

KvError(KvError)

EmailRecipientSuppressed(String)

Email recipient is on the suppression list (typically due to prior bounces or complaints) and cannot be delivered to.

EmailRecipientNotAllowed(String)

Email recipient is not allowed for this sender (policy/restriction).

Distinct from EmailRecipientSuppressed: suppression is a delivery outcome, “not allowed” is a sender-policy refusal.

RateLimitExceeded(String)

Cloudflare rate limit exceeded.

Currently only produced by the email forwarder. May be produced by other rate-limited subsystems in the future.

DailyLimitExceeded(String)

Cloudflare daily limit exceeded.

Currently only produced by the email forwarder. May be produced by other quota-limited subsystems in the future.

InternalError(String)

A backend Cloudflare service reported an internal error.

Generally transient; consider retrying with backoff.

Currently only produced by the email forwarder. May be produced by other subsystems in the future.

UnknownJsError

A JavaScript error that didn’t match any structured variant.

This is the catch-all for errors thrown by the Workers runtime or user code that don’t carry a recognized error code.

Always produced by converting from a JsValue; not intended to be constructed directly from Rust code. Round-tripping back to JsValue returns the stored original, so the original error object identity (stack, prototype, extra properties) is preserved.

Fields

original: JsValue

The original error value.

name: Option<String>

Cached name extracted at conversion time.

message: String

Cached message extracted at conversion time.

code: Option<String>

Cached code extracted at conversion time.

cause: Option<Box<Error>>

Recursively converted cause.

Implementations

impl Error

pub fn to_js_value(&self) -> JsValue

Build a JsValue representation of this error without consuming it.

For variants holding a stored JsValue (UnknownJsError, Internal), this clones the original — cheap, since JsValue::clone is a refcount bump on the V8 anchor table. Other variants reconstruct a fresh js_sys::Error with the same code/message as the consuming From<Error> for JsValue impl.

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 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<'_derivative_strum> From<&'_derivative_strum Error> for &'static str

fn from(x: &'_derivative_strum Error) -> &'static str

Converts to this type from the input type.

impl From<&str> for Error

fn from(a: &str) -> Self

Converts to this type from the input type.

impl From<D1Error> for Error

Available on crate feature d1 only.

fn from(e: D1Error) -> Self

Converts to this type from the input type.

impl From<Error> for &'static str

fn from(x: Error) -> &'static str

Converts to this type from the input type.

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

Available on crate feature http only.

fn from(value: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for JsValue

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Infallible> for Error

fn from(_value: Infallible) -> Self

Converts to this type from the input type.

impl From<InsertError> for Error

fn from(e: InsertError) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderName> for Error

Available on crate feature http only.

fn from(value: InvalidHeaderName) -> Self

Converts to this type from the input type.

impl From<InvalidHeaderValue> for Error

Available on crate feature http only.

fn from(value: InvalidHeaderValue) -> Self

Converts to this type from the input type.

impl From<InvalidStatusCode> for Error

Available on crate feature http only.

fn from(value: InvalidStatusCode) -> Self

Converts to this type from the input type.

impl From<JsValue> for Error

fn from(v: JsValue) -> Self

Converts to this type from the input type.

impl From<KvError> for Error

fn from(e: KvError) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

Available on crate feature timezone only.

fn from(_value: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for Error

fn from(e: ParseError) -> Self

Converts to this type from the input type.

impl From<String> for Error

fn from(a: String) -> Self

Converts to this type from the input type.

impl From<Utf8Error> for Error

fn from(value: Utf8Error) -> Self

Converts to this type from the input type.