Struct ParseError 

pub struct ParseError {
    pub raw_line: String,
    pub raw_json: Option<Value>,
    pub error_message: String,
    pub method: Option<String>,
}

Error type for parsing failures that preserves the raw frame data.

Returned inside Error::Deserialization when a message from the app-server fails to deserialize. The structured fields let consumers render the offending frame in bug reports without grepping logs.

Two failure modes are represented:

1. Bare JSON failure — the line wasn’t valid JSON, or the JSON didn’t match the JsonRpcMessage envelope. raw_line is the original line from stdout. raw_json is populated when the line parsed as JSON but didn’t fit the envelope; None when the line wasn’t even JSON. method is None.

2. Typed decode failure — the envelope parsed fine (so the JSON-RPC method is known), but the typed payload decode (Notification::from_envelope / ServerRequest::from_envelope) failed on the params. method carries the JSON-RPC method name. raw_json carries the params value. raw_line is the re-serialized envelope — wire-equivalent to what came in, suitable for pasting into a bug report.

Fields

raw_line: String

Line from stdout (or re-serialized envelope, for typed-decode failures).

raw_json: Option<Value>

Parsed JSON value when available (the params for typed-decode failures; the parsed line for envelope-shape failures).

error_message: String

The underlying serde error description.

method: Option<String>

JSON-RPC method name when the failure happened at the typed-decode stage. None for bare-JSON / envelope-shape failures.

Implementations

impl ParseError

pub fn from_line(line: impl Into<String>, error: Error) -> Self

Build a ParseError for a bare-JSON or envelope-shape failure.

pub fn from_envelope( method: impl Into<String>, params: Option<Value>, error: Error, ) -> Self

Build a ParseError for a typed-decode failure on a notification or request whose envelope parsed but whose params did not match.

raw_line is reconstructed by re-serializing the envelope so consumers can render the full offending frame even though the original line was already consumed by the envelope decode.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

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 From<ParseError> for Error

fn from(source: ParseError) -> Self

Converts to this type from the input type.