detached(executorPreference:priority:operation:)

Runs the given throwing operation asynchronously as part of a new top-level task.

iOS: 18.0+
macOS: 15.0+
tvOS: 18.0+
visionOS: 2.0+
watchOS: 11.0+

@discardableResult static func detached(executorPreference taskExecutor: (any TaskExecutor)?, priority: TaskPriority? = nil, operation: sending @escaping () async throws -> Success) -> Task<Success, Failure>

Mangled symbol

sScT12_Concurrencys5Error_pRs_rlE8detached18executorPreference8priority9operationScTyxsAB_pGSch_pSg_ScPSgxyYaKcntFZ What are these?

FNV24 hash: 7VNFX

Constraints

where Failure == any Error, Success:Sendable

Parameters

taskExecutor: the preferred task executor for this task, and any child tasks created by it. Explicitly passing nil is interpreted as “no preference”.
priority: The priority of the task. Pass nil to use the priority from Task.currentPriority.
operation: The operation to perform.

Returns

A reference to the newly created task.

If the operation throws an error, this method propagates that error.

Don’t use a detached task if it’s possible to model the operation using structured concurrency features like child tasks. Child tasks inherit the parent task’s priority and task-local storage, and canceling a parent task automatically cancels all of its child tasks. You need to handle these considerations manually with a detached task.

You need to keep a reference to the detached task if you want to cancel it by calling the Task.cancel() method. Discarding your reference to a detached task doesn’t implicitly cancel that task, it only makes it impossible for you to explicitly cancel the task.