Enum HandlerError 

pub enum HandlerError {
    Retry(String),
    RetryAfter(String, Duration),
    Permanent(String),
}

The error a job handler returns to nack its job, choosing how it should be retried.

Each variant maps to a RetryDirective: Retry → Default, RetryAfter → After, Permanent → DeadLetter. Use the retry, retry_after, and permanent constructors rather than the variants directly.

Variants

Retry(String)

Retry using the queue’s default retry policy.

RetryAfter(String, Duration)

Retry, but not before the given delay.

Permanent(String)

Do not retry; dead-letter the job immediately.

Implementations

impl HandlerError

pub fn retry(reason: impl Into<String>) -> Self

Nack the job for retry under the queue’s default policy.

pub fn retry_after(reason: impl Into<String>, delay: Duration) -> Self

Nack the job for retry after at least delay.

pub fn permanent(reason: impl Into<String>) -> Self

Nack the job as a permanent failure, sending it straight to the dead-letter queue.

Trait Implementations

impl Debug for HandlerError

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

Formats the value using the given formatter.

impl Display for HandlerError

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

Formats the value using the given formatter.

impl Error for HandlerError

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.