Enum TaskExecutionError 

pub enum TaskExecutionError<E> {
    Failed(E),
    Panicked,
    Cancelled,
    Dropped,
}

Error observed when retrieving the result of an accepted task.

This error is distinct from SubmissionError. Rejection happens before a service accepts a task; TaskExecutionError describes what happened after the task was accepted.

Type Parameters

• E - The error type returned by the task itself.

Variants

Failed(E)

The task ran and returned Err(E).

Panicked

The task panicked while running.

Cancelled

The task was explicitly cancelled before producing a result.

This includes caller-side cancellation through tracked handles and executor/service-side cancellation of queued, scheduled, or otherwise unstarted work.

Dropped

The accepted runner-side completion endpoint was abandoned without publishing an explicit terminal result.

This represents runner loss or misuse. Services that intentionally stop unstarted accepted work should publish Self::Cancelled instead.

Implementations

impl<E> TaskExecutionError<E>

pub const fn is_failed(&self) -> bool

Returns true when this error wraps the task’s own error value.

Returns

true if the task returned Err(E).

pub const fn is_panicked(&self) -> bool

Returns true when the task panicked.

Returns

true if the task panicked while running.

pub const fn is_cancelled(&self) -> bool

Returns true when the task was explicitly cancelled.

Returns

true if the task was cancelled before producing a result.

pub const fn is_dropped(&self) -> bool

Returns true when the task result was abandoned by the completion endpoint.

Returns

true if the accepted runner-side completion endpoint disappeared without publishing an explicit terminal result.

Trait Implementations

impl<E: Debug> Debug for TaskExecutionError<E>

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

Formats the value using the given formatter.

impl<E> Display for TaskExecutionError<E>

where E: Display,

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

Formats this task execution error for users.

impl<E> Error for TaskExecutionError<E>

where E: Error + 'static,

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.