v0.2.6-alpha.3

Swift: Cancel an attachment

attachmentCancel(_:) stops one attachment's transfer at the app's request. The row lands failed but not permanent, so the next drive may take it again; canceling is not a budget charge.

Examples#

Basic#

// TodoApp/AttachmentView.swift (excerpt)
import KizunaSync

let canceled = try await kizunasync.attachmentCancel(reference)

Let the user stop a large upload#

// TodoApp/AttachmentView.swift (excerpt)
import KizunaSync
import SwiftUI

Button("Cancel upload") {
  Task { _ = try? await kizunasync.attachmentCancel(reference) }
}

Parameters#

Name	Type	Required	Description
`reference`	`String`	Yes	The value stored in the row's attachment column.

Returns#

Bool. true when a row carried the reference, false when none did.

Errors#

Code	Condition
`STORE`	The row could not be written.
`ENGINE_UNAVAILABLE`	The bridge answered with an envelope carrying no code, which is not a gradeable failure.
`ENGINE_UNAVAILABLE`	The client has no engine because Initializing has not run.

Notes#

Cancel does not stop bytes already in flight to the transport mid-request. It marks the row so the queue stops driving it. Unlike an ordinary transfer failure, it does not count against attachmentAttempts. That difference tells a canceled row apart from a budget-stopped one in Get attachment status: both read state: "failed", and only the budget-stopped one reads permanent: true.

This method reaches the kernel through the same JSON-RPC call every typed method uses underneath; it behaves like any other client method and raises the same KizunaSyncError.engine.

← Retry an attachment Remove an attachment →

Found a problem? Edit this page on GitHub