Struct DatabaseError 

pub struct DatabaseError { /* private fields */ }

An error the database returned for a statement.

Neither D1 nor Durable Object storage reports a structured result code across the binding, only SQLite’s message as text, which ends with the code by name: NOT NULL constraint failed: users.email: SQLITE_CONSTRAINT (extended: SQLITE_CONSTRAINT_NOTNULL). code is that name, and kind is read from it.

Implementations

impl DatabaseError

pub fn new(message: String) -> Self

The error for message, as the backend threw it.

Trait Implementations

impl Clone for DatabaseError

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl DatabaseError for DatabaseError

fn code(&self) -> Option<Cow<'_, str>>

SQLite’s result code by name – the extended one when the message has it, as in SQLITE_CONSTRAINT_UNIQUE, else the primary one.

fn message(&self) -> &str

The primary, human-readable error message.

fn kind(&self) -> ErrorKind

Returns the kind of the error, if supported.

fn constraint(&self) -> Option<&str>

Returns the name of the constraint that triggered the error, if applicable. If the error was caused by a conflict of a unique index, this will be the index name.

fn table(&self) -> Option<&str>

Returns the name of the table that was affected by the error, if applicable.

fn is_unique_violation(&self) -> bool

Returns whether the error kind is a violation of a unique/primary key constraint.

fn is_foreign_key_violation(&self) -> bool

Returns whether the error kind is a violation of a foreign key.

fn is_check_violation(&self) -> bool

Returns whether the error kind is a violation of a check.

impl Debug for DatabaseError

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

Formats the value using the given formatter.

impl Display for DatabaseError

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

Formats the value using the given formatter.

impl Eq for DatabaseError

impl Error for DatabaseError

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 PartialEq for DatabaseError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for DatabaseError