Struct PendingTaskInfo 

#[non_exhaustive]
pub struct PendingTaskInfo {
    pub task_kind: String,
    pub identifier: String,
    pub received_at: f64,
    pub consumed_at: Option<f64>,
}

Information about a pending iOS background task that launched the app.

Returned by getPendingBgTask() on iOS when the app was launched by iOS for a background task (BGAppRefreshTask or BGProcessingTask). Used by the Rust auto-start logic to detect OS-initiated launches and automatically start the service if desired_running is true.

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.

task_kind: String

The kind of background task: “refresh” or “processing”.

identifier: String

The task identifier (e.g. “com.example.app.bg-refresh”).

received_at: f64

Epoch timestamp (seconds) when the task was received by the native layer.

consumed_at: Option<f64>

Epoch timestamp (seconds) when the pending task was consumed by the Rust auto-start logic. None until clear_pending_bg_task is called.

Implementations

impl PendingTaskInfo

pub fn from_pending_payload(value: &Value) -> Result<Option<Self>, Error>

Resolve a raw getPendingBgTask payload to an active pending task.

Enforces the H5/M14 invariant pending ⟺ consumedAt == nil: a payload with a null taskKind (no record) or a non-null consumedAt (already consumed/stale) yields None; only a fresh, unconsumed record is surfaced. This mirrors the Swift getPendingBgTask gate on the Rust side so a consumed record can’t re-arm a cold auto-start even if the native payload still carries the keys — gating on consumed_at, not only taskKind.is_null().

Trait Implementations

impl Clone for PendingTaskInfo

fn clone(&self) -> PendingTaskInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PendingTaskInfo

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PendingTaskInfo

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PendingTaskInfo

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PendingTaskInfo

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 PendingTaskInfo