Struct EmailAddress 

#[non_exhaustive]
pub struct EmailAddress {
    pub at_type: Option<String>,
    pub address: String,
    pub contexts: Option<HashMap<String, bool>>,
    pub pref: Option<u32>,
    pub label: Option<String>,
    pub extra: Map<String, Value>,
}

An email address (RFC 9553 §2.3.1).

Distinct from the JMAP Mail RFC 8621 §2 binding type jmap_mail_types::EmailAddress: that type carries an RFC 5322 mailbox (name + email) and appears in Email.from / Email.to etc., whereas this EmailAddress is a JSContact sub-object embedded in a ContactCard.emails map.

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.

at_type: Option<String>

Object type discriminator; SHOULD be "EmailAddress" when present per RFC 9553 §1.3.4 (may be omitted in defaultType positions).

address: String

The email address. Must be an RFC 5322 addr-spec.

contexts: Option<HashMap<String, bool>>

Contexts in which to use the address (key → true).

pref: Option<u32>

Preference order in 1..=100 (lower = more preferred).

label: Option<String>

Custom label for the value.

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).

Trait Implementations

impl Clone for EmailAddress

fn clone(&self) -> EmailAddress

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmailAddress

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for EmailAddress

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EmailAddress

impl PartialEq for EmailAddress

fn eq(&self, other: &EmailAddress) -> 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 Serialize for EmailAddress

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 EmailAddress