Struct Notification 

pub struct Notification {

    pub title: String,
    pub body: String,
    pub category: Option<String>,
    pub thread_id: Option<String>,
    pub data: Value,
    pub collapse_id: Option<String>,
    pub priority: Priority,
    pub icon: Option<String>,
    pub url: Option<String>,
    pub ttl: Option<Duration>,
    pub badge: Option<u32>,
    pub silent: bool,
    pub loc: Option<LocKeys>,
}

One notification, in transport-neutral terms. data is the custom key-value payload the app reads; collapse_id coalesces notifications the user has not seen yet.

Every optional field is a request: an adapter maps what its protocol has and documents what it drops (APNs has no icon, Web Push has no badge).

Fields

title: String

body: String

category: Option<String>

The notification category (an app-defined action group).

thread_id: Option<String>

Groups related notifications in the UI.

data: Value

Custom payload the app reads; merged alongside the aps block.

collapse_id: Option<String>

Coalesces with any undelivered notification carrying the same id. apns-collapse-id / android.collapse_key / the Web Push Topic header (≤32 URL-safe characters, so a Web Push adapter shortens it and documents how).

priority: Priority

icon: Option<String>

An icon for the notification (Web Push icon; ignored by APNs, which takes its icon from the app bundle).

url: Option<String>

Where a tap should take the user: the Web Push click target, FCM’s click_action, and a top-level url in the APNs payload.

ttl: Option<Duration>

How long the push service may hold the notification while the device is offline. Serialised as whole seconds, through ttl_secs.

Note the wire forms differ: apns-expiration is an absolute UNIX epoch, so the APNs adapter sends now + ttl; android.ttl is "<s>s"; Web Push TTL is seconds. A zero TTL means “deliver now or drop” in all three.

Sub-second TTLs round up to one second, on the wire and in every adapter: Duration::from_millis(900) is a request to hold the notification briefly, and truncating it to 0 would turn it into the opposite instruction — drop it the moment the device is offline — silently, and again on every serde round trip. Only Duration::ZERO means “drop if undeliverable now”.

badge: Option<u32>

The badge number to show on the app icon (iOS). Ignored elsewhere.

silent: bool

A data-only notification: nothing is shown, the app is woken to do work (content-available / FCM data message).

loc: Option<LocKeys>

Native localisation keys, in place of title/body, where the platform supports them.

Implementations

impl Notification

pub fn new(title: impl Into<String>, body: impl Into<String>) -> Self

A minimal notification with a title and body.

Trait Implementations

impl Clone for Notification

fn clone(&self) -> Notification

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Notification

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Notification

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Notification

impl PartialEq for Notification

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Notification

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 Notification