Struct JsonDecodeError 

#[non_exhaustive]
pub struct JsonDecodeError {
    pub kind: JsonDecodeErrorKind,
    pub stage: JsonDecodeStage,
    pub message: String,
    pub expected_top_level: Option<JsonTopLevelKind>,
    pub actual_top_level: Option<JsonTopLevelKind>,
    pub line: Option<usize>,
    pub column: Option<usize>,
    pub input_bytes: Option<usize>,
    pub max_input_bytes: Option<usize>,
    /* private fields */
}

Error returned when lenient JSON decoding fails.

This value captures both a stable category in JsonDecodeErrorKind and human-readable context that can be logged or surfaced to the caller.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

kind: JsonDecodeErrorKind

Identifies the stable category of this decoding failure.

Callers should match on this field when they need programmatic handling that is independent from localized or parser-specific text.

stage: JsonDecodeStage

Identifies which decode stage produced this error.

message: String

Stores a human-readable summary of the decoding failure.

The message is intended for diagnostics and normally includes the relevant parsing or deserialization context.

expected_top_level: Option<JsonTopLevelKind>

Stores the top-level JSON kind required by the caller, when applicable.

This field is only populated for errors raised by constrained decoding methods such as decode_object() and decode_array().

actual_top_level: Option<JsonTopLevelKind>

Stores the top-level JSON kind that was actually parsed, when known.

This field is only populated together with expected_top_level for top-level contract mismatches.

line: Option<usize>

Stores the one-based line reported by serde_json, when available.

This field is primarily useful for invalid JSON syntax and deserialization failures that can be mapped back to a parser location.

column: Option<usize>

Stores the one-based column reported by serde_json, when available.

Like line, this field is only populated when the lower-level parser or deserializer reports a concrete source position.

input_bytes: Option<usize>

Stores the input byte length associated with the failure, when known.

max_input_bytes: Option<usize>

Stores the configured maximum input byte length, when relevant.

Trait Implementations

impl Clone for JsonDecodeError

fn clone(&self) -> JsonDecodeError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JsonDecodeError

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

Formats the value using the given formatter.

impl Display for JsonDecodeError

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

Formats the value using the given formatter.

impl Error for JsonDecodeError

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 JsonDecodeError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for JsonDecodeError