型プロパティ

name

タスクの作成中に設定されている場合、現在のタスクの人間が読める名前を返します。

static var name: String? { get }

Success が Never であり Failure が Never である場合時利用可能です。

議論

タスクはその作成中に名前を付けることができるため、同じソースの場所で作成される可能性のある一意のタスクを識別するのに役立ちます。以下に例を示します。

func process(items: [Int]) async {
  await withTaskGroup { group in
    for item in items {
      group.addTask(name: "process-\(item)") {
        await process(item)
      }
    }
  }
}

タスク名の利用可能性

タスク名は、最新の実行時（Swift 6.2 以降）で実行している場合にのみ利用可能です。

タスク名を受け入れる可能性のある Task イニシャライザーは、便宜上、このプロパティよりも利用可能です。これは、タスク名を条件付きで設定する必要がないようにするためです。ただし、その効果は実行時に依存し、このプロパティの利用可能性に反映されます。