Enum Error 

#[non_exhaustive]
pub enum Error {
    Configuration(ConfigError),
    Serialization(Error),
    Request(Error),
    ResponseBody {
        metadata: Box<ResponseMetadata>,
        source: Error,
    },
    Postgrest {
        metadata: Box<ResponseMetadata>,
        source: Box<PostgrestError>,
    },
    Decode {
        metadata: Box<ResponseMetadata>,
        source: Box<DecodeError>,
    },
    ResponseDecode {
        metadata: Box<ResponseMetadata>,
        source: Error,
    },
    Count {
        metadata: Box<ResponseMetadata>,
        source: CountError,
    },
}

A configuration, request, or response failure, without nested result layers.

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.

Configuration(ConfigError)

Invalid client or request configuration.

Serialization(Error)

Deferred payload serialization failure.

Request(Error)

No usable HTTP response was received.

ResponseBody

Reading a successful or unsuccessful response body failed.

Fields

metadata: Box<ResponseMetadata>

source: Error

Postgrest

A structured server error; observed HTTP status is authoritative.

Fields

metadata: Box<ResponseMetadata>

source: Box<PostgrestError>

Decode

A malformed error envelope, retaining exact body bytes in its source.

Fields

metadata: Box<ResponseMetadata>

source: Box<DecodeError>

ResponseDecode

A successful response did not match the requested JSON shape.

Fields

metadata: Box<ResponseMetadata>

source: Error

Count

A requested row count was missing or invalid.

Fields

metadata: Box<ResponseMetadata>

source: CountError

Implementations

impl Error

pub fn server_response(&self) -> Option<(StatusCode, Option<&ErrorResponse>)>

Observed non-success HTTP status and any decoded server error body.

Malformed envelopes and failed body reads retain their status with no body. Successful-response decode and count failures are not server errors.

pub fn is_jwt_expired(&self) -> bool

Whether a JWT validation error specifically reports token expiration.

Other JWT failures, including invalid signatures, return false.

pub const fn postgrest_error(&self) -> Option<&PostgrestError>

The decoded structured server error without destructuring this error.

pub fn postgrest_body(&self) -> Option<&ErrorResponse>

The decoded server response, including code, details and hint.

pub fn postgrest_response(&self) -> Option<(StatusCode, &ErrorResponse)>

The authoritative HTTP status and borrowed structured server response.

The status comes from the observed response, not the error code’s inferred status. Returns None when no structured server error was decoded.

pub const fn response_metadata(&self) -> Option<&ResponseMetadata>

Metadata when a response was observed.

pub fn status(&self) -> Option<StatusCode>

Authoritative observed HTTP status, if available.

pub fn url(&self) -> Option<&Url>

Effective response URL, or the failed request URL.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

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

fn from(source: ConfigError) -> Error

Converts to this type from the input type.

impl From<Error> for SupabaseClientError

fn from(source: Error) -> Self

Converts to this type from the input type.