Enum SseError 

pub enum SseError {
    NoData,
    MalformedId,
    MalformedName(EventNameError),
    Unserialisable,
}

Why a frame could not be read or written.

The variants are what a caller can act on separately: a frame that cannot be serialised is this process’s bug, a corrupt id is the peer’s, and a block with no data is not a failure at all — the standard simply dispatches nothing for it.

Variants

NoData

The block carried no data: field, so the standard dispatches no event.

MalformedId

An id: field was not a decimal event id.

Carries nothing from the input on purpose. The value came from a peer, it may be arbitrarily long, and a refusal that echoes it would be reflecting untrusted input into a response body for no diagnostic gain: the peer knows what it sent.

MalformedName(EventNameError)

An event: field was not a usable event name.

Carries the EventNameError because the two reasons are worth telling apart when reading a log: an empty name is a peer that wrote event: and nothing else, and a name holding a line terminator is a peer — or something pretending to be one — that tried to smuggle a second field through a frame. Neither echoes the offending value, for the reason MalformedId does not.

Unserialisable

The value has a map key that is not a string, so it has no JSON form.

Trait Implementations

impl Clone for SseError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SseError

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

Formats the value using the given formatter.

impl Display for SseError

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

Formats the value using the given formatter.

impl Eq for SseError

impl Error for SseError

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<SseError> for FrameError

fn from(source: SseError) -> Self

Converts to this type from the input type.

impl PartialEq for SseError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SseError