Enum Error

pub enum Error {
    OutOfMemory {
        source: ErrorSource,
    },
    Validation {
        source: ErrorSource,
        description: String,
    },
    Internal {
        source: ErrorSource,
        description: String,
    },
}

Errors resulting from usage of GPU APIs.

By default, errors translate into panics. Depending on the backend and circumstances, errors may occur synchronously or asynchronously. When errors need to be handled, use Device::push_error_scope() or Device::on_uncaptured_error().

Variants

OutOfMemory

Out of memory.

Fields

source: ErrorSource

Lower level source of the error.

Validation

Validation error, signifying a bug in code or data provided to wgpu.

Fields

source: ErrorSource

Lower level source of the error.

description: String

Description of the validation error.

Internal

Internal error. Used for signalling any failures not explicitly expected by WebGPU.

These could be due to internal implementation or system limits being reached.

Fields

source: ErrorSource

Lower level source of the error.

description: String

Description of the internal GPU error.

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.