downloadTask(withResumeData:completionHandler:)

func downloadTask(withResumeData resumeData: Data, 
completionHandler: @escaping (URL?, URLResponse?, Error?) -> Void) -> URLSessionDownloadTask

Return Value 戻り値

The new session download task. 新しいセッションダウンロードタスク。

Discussion 議論

By using a completion handler, the task bypasses calls to delegate methods for response and data delivery, and instead provides any resulting data, response, or error inside the completion handler. Delegate methods for handling authentication challenges, however, are still called. 完了ハンドラを使うことによって、タスクは応答とデータを配達するための委任先メソッドへの呼び出しを迂回します、そして代わりに何らかの結果データ、応答、そしてエラーを完了ハンドラ内部で提供します。認証チャレンジを取り扱う委任先メソッドは、しかしながら、依然として呼び出されます。

You should pass a nil completion handler only when creating tasks in sessions whose delegates include a urlSession(_:downloadTask:didFinishDownloadingTo:) method. あなたがnil完了ハンドラを渡すべきなのは唯一、委任先がurlSession(_:downloadTask:didFinishDownloadingTo:)メソッドを含むセッションにおいて、それらタスクを作成している時です。

Your app can obtain a resumeData object in two ways: あなたのアプリは、resumeDataオブジェクトを２つの方法で入手します：

• If your app cancels an existing transfer by calling cancel(byProducingResumeData:), the session object passes a resumeData object to the completion handler that you provided in that call. あなたのアプリがある既存の転送をcancel(byProducingResumeData:)を呼び出すことによって取り消すならば、セッションオブジェクトはresumeDataオブジェクトを、あなたがその呼び出しにおいて提供した完了ハンドラへと渡します。

• If a transfer fails, the session object provides an NSError object either to its delegate or to the task’s completion handler. In that object, the NSURLSessionDownloadTaskResumeData key in the userInfo dictionary contains a resumeData object. 転送が失敗するならば、セッションオブジェクトは、NSErrorオブジェクトを、それの委任先へまたはタスクのもつ完了ハンドラへのどちらかに提供します。そのオブジェクトにおいて、NSURLSessionDownloadTaskResumeDataキーはuserInfo辞書において、resumeDataオブジェクトを含みます。

After you create the task, you must start it by calling its resume() method. あなたがタスクを作成する後、あなたはそれを、それのresume()メソッドを呼び出すことによって開始しなければなりません。

If the request completes successfully, the location parameter of the completion handler block contains the location of the temporary file, and the error parameter is nil. If the request fails, the location parameter is nil and the error parameter contain information about the failure. If a response from the server is received, regardless of whether the request completes successfully or fails, the response parameter contains that information. リクエストが成功裏に完了するならば、完了ハンドラブロックのlocationパラメータは一時ファイルの場所を含みます、そしてerrorパラメータはnilです。リクエストが失敗するならば、locationパラメータはnilです、そしてerrorパラメータはその失敗についての情報を含みます。サーバからの応答が受け取られるならば、リクエストがうまく完了するか失敗するかどうかに関係なく、responseパラメータはその情報を含みます。