Struct SearchSnippet 

#[non_exhaustive]
pub struct SearchSnippet {
    pub email_id: Id,
    pub subject: Option<String>,
    pub preview: Option<String>,
    pub extra: Map<String, Value>,
}

A search result snippet for one Email (RFC 8621 §5).

Returned by SearchSnippet/get. Note that SearchSnippet has no id field — it is identified by email_id instead.

The subject and preview fields are None when the server could not determine a snippet for that Email. Per RFC 8620 §5.1, absent and null are semantically equivalent for |null properties, so these fields are omitted from serialized JSON (rather than emitted as null) when None.

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.

email_id: Id

The Email id the snippet applies to.

subject: Option<String>

Subject of the Email with matching words wrapped in <mark> tags, or null if the subject did not match the filter.

preview: Option<String>

Relevant section of the body with matching words wrapped in <mark> tags (max 255 octets), or null if the body did not match the filter.

extra: Map<String, Value>

Catch-all for vendor / site / private extension fields not covered by the typed fields above. Preserves unknown fields across deserialize/serialize round-trip per workspace extras-preservation policy (see workspace AGENTS.md).

Implementations

impl SearchSnippet

pub fn new(email_id: Id) -> Self

Construct a SearchSnippet with no subject or preview match.

Trait Implementations

impl Clone for SearchSnippet

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 SearchSnippet

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SearchSnippet

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SearchSnippet

impl JmapObject for SearchSnippet

const TYPE_NAME: &'static str = "SearchSnippet"

The JMAP type name string (e.g. "Email", "Mailbox", "Chat").

type Property = SearchSnippetProperty

The property selector enum for this type (server-side only, no serde).

impl PartialEq for SearchSnippet

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SearchSnippet

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SearchSnippet