Struct ParseError 

pub struct ParseError {
    pub code: ErrorCode,
    pub message: String,
    pub origin: ErrorOrigin,
    pub info: ParseErrorInfo,
}

A Parse error: a code plus a message, plus how much of it may be seen.

No source chaining and no automatic From conversions from I/O or driver errors. That is deliberate: mapping a storage failure onto a Parse code is a decision each adapter must make explicitly, because picking the wrong code is a wire-compatibility bug that no type system will catch.

Fields

code: ErrorCode

message: String

origin: ErrorOrigin

Which envelope this becomes. See ErrorOrigin.

info: ParseErrorInfo

Data for the server, never for the client. See ParseErrorInfo.

Implementations

impl ParseError

pub fn new(code: ErrorCode, message: impl Into<String>) -> Self

pub fn internal(detail: impl Into<String>) -> Self

A failure upstream throws as a bare Error, so its detail never reaches a client.

The client sees {"code":1,"message":"Internal server error."} whatever detail says (middlewares.js:636-644); detail is logged and is the only record of what happened. Write it for an operator reading a log, not for an SDK.

Use this wherever upstream throws a plain Error, and new(ErrorCode::InternalServerError, ..) where upstream throws a Parse.Error carrying that code. The two are different bodies.

pub fn with_duplicated_field(self, field: impl Into<String>) -> Self

Record which field’s unique index collided, out of band.

pub fn duplicated_field(&self) -> Option<&str>

The field whose unique index collided, if the adapter could recover it.

impl ParseError

Denials whose detail is logged and, by default, withheld.

pub fn sanitized( code: ErrorCode, detailed: impl Into<String>, generic: &str, detail: ErrorDetail, ) -> Self

createSanitizedError (Error.js:13-21): the single constructor for a denial whose detailed message upstream replaces with a generic one.

The set of call sites is contract in both directions. Upstream routes a specific list of errors through this function and leaves the rest alone, so an error parse-rust sanitizes that upstream does not is as much a wire divergence as one it fails to sanitize. Adding a call here means finding the matching createSanitizedError at the pin first.

generic is upstream’s sanitizedMessage parameter, which defaults to Permission denied and is overridden at exactly one call site (DatabaseController.js:1590-1595). It is required here rather than defaulted, because the two upstream spellings are different strings on the wire and picking the wrong one silently is the failure this argument exists to prevent.

pub fn permission_denied( code: ErrorCode, detailed: impl Into<String>, detail: ErrorDetail, ) -> Self

The common case: upstream’s default sanitizedMessage.

impl ParseError

Convenience constructors for the codes used most often in the core.

pub fn invalid_json(message: impl Into<String>) -> Self

pub fn incorrect_type(message: impl Into<String>) -> Self

pub fn invalid_key_name(message: impl Into<String>) -> Self

pub fn invalid_acl(message: impl Into<String>) -> Self

pub fn invalid_query(message: impl Into<String>) -> Self

Trait Implementations

impl Clone for ParseError

fn clone(&self) -> ParseError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Eq for ParseError

impl Error for ParseError

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 ParseError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ParseError