イニシャライザー

init(name:priority:operation:)

与えられた throw する操作を、新しい 非構造化 トップレベルタスクの一部として非同期的に実行します。

@discardableResult
init(
    name: String? = nil,
    priority: TaskPriority? = nil,
    operation: sending @escaping @isolated(any) () async throws -> Success
)

Success が Sendable に準拠し Failure が any Error である場合時利用可能です。

パラメータ

name

人間が判読できるタスクの名前。

priority

操作タスクの優先度。

operation

実行すべき操作。

戻り値

タスクへの参照。

議論

operation (操作) でエラーを throw した場合、そのエラーは Task によってキャッチされ、タスクの value が待機されるときにのみ再度スローされます。タスクの結果値を待機しないことで、誤ってエラーを無視しないように注意してください。

Task.cancel() メソッドを呼び出してタスクをキャンセルしたい場合は、タスクへの参照を保持する必要があります。タスクへの参照を破棄しても、そのタスクが暗黙的にキャンセルされるわけではなく、明示的にタスクをキャンセルできなくなるだけです。