All Superinterfaces:

NSURLSessionDelegate

All Known Subinterfaces:

AVAssetDownloadDelegate, NSURLSessionDataDelegate, NSURLSessionDownloadDelegate, NSURLSessionStreamDelegate, NSURLSessionWebSocketDelegate
```
public interface NSURLSessionTaskDelegate
extends NSURLSessionDelegate
```
Messages related to the operation of a specific task. API-Since: 7.0

Nested Class Summary

Nested Classes
Modifier and Type	Interface	Description
`static interface`	`NSURLSessionTaskDelegate.Block_URLSessionTaskDidReceiveChallengeCompletionHandler`
`static interface`	`NSURLSessionTaskDelegate.Block_URLSessionTaskNeedNewBodyStream`
`static interface`	`NSURLSessionTaskDelegate.Block_URLSessionTaskNeedNewBodyStreamFromOffsetCompletionHandler`
`static interface`	`NSURLSessionTaskDelegate.Block_URLSessionTaskWillBeginDelayedRequestCompletionHandler`
`static interface`	`NSURLSessionTaskDelegate.Block_URLSessionTaskWillPerformHTTPRedirectionNewRequestCompletionHandler`

Nested classes/interfaces inherited from interface apple.foundation.protocol.NSURLSessionDelegate
NSURLSessionDelegate.Block_URLSessionDidReceiveChallengeCompletionHandler

Method Summary

All Methods Instance Methods Default Methods
Modifier and Type	Method	Description
`default void`	`URLSessionDidCreateTask(@NotNull NSURLSession session, @NotNull NSURLSessionTask task)`	Notification that a task has been created.
`default void`	`URLSessionTaskDidCompleteWithError(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @Nullable NSError error)`	Sent as the last message related to a specific task.
`default void`	`URLSessionTaskDidFinishCollectingMetrics(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @NotNull NSURLSessionTaskMetrics metrics)`	Sent when complete statistics information has been collected for the task.
`default void`	`URLSessionTaskDidReceiveChallengeCompletionHandler(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @NotNull NSURLAuthenticationChallenge challenge, @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskDidReceiveChallengeCompletionHandler completionHandler)`	The task has received a request specific authentication challenge.
`default void`	`URLSessionTaskDidReceiveInformationalResponse(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @NotNull NSHTTPURLResponse response)`	Sent for each informational response received except 101 switching protocols.
`default void`	`URLSessionTaskDidSendBodyDataTotalBytesSentTotalBytesExpectedToSend(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, long bytesSent, long totalBytesSent, long totalBytesExpectedToSend)`	Sent periodically to notify the delegate of upload progress.
`default void`	`URLSessionTaskIsWaitingForConnectivity(@NotNull NSURLSession session, @NotNull NSURLSessionTask task)`	Sent when a task cannot start the network loading process because the current network connectivity is not available or sufficient for the task's request.
`default void`	`URLSessionTaskNeedNewBodyStream(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskNeedNewBodyStream completionHandler)`	Sent if a task requires a new, unopened body stream.
`default void`	`URLSessionTaskNeedNewBodyStreamFromOffsetCompletionHandler(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, long offset, @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskNeedNewBodyStreamFromOffsetCompletionHandler completionHandler)`	Tells the delegate if a task requires a new body stream starting from the given offset.
`default void`	`URLSessionTaskWillBeginDelayedRequestCompletionHandler(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @NotNull NSURLRequest request, @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskWillBeginDelayedRequestCompletionHandler completionHandler)`	Sent when the system is ready to begin work for a task with a delayed start time set (using the earliestBeginDate property).
`default void`	`URLSessionTaskWillPerformHTTPRedirectionNewRequestCompletionHandler(@NotNull NSURLSession session, @NotNull NSURLSessionTask task, @NotNull NSHTTPURLResponse response, @NotNull NSURLRequest request, @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskWillPerformHTTPRedirectionNewRequestCompletionHandler completionHandler)`	An HTTP request is attempting to perform a redirection to a different URL.

Methods inherited from interface apple.foundation.protocol.NSURLSessionDelegate
URLSessionDidBecomeInvalidWithError, URLSessionDidFinishEventsForBackgroundURLSession, URLSessionDidReceiveChallengeCompletionHandler

Method Detail

URLSessionTaskDidCompleteWithError

default void URLSessionTaskDidCompleteWithError(@NotNull
                                                @NotNull NSURLSession session,
                                                @NotNull
                                                @NotNull NSURLSessionTask task,
                                                @Nullable
                                                @Nullable NSError error)

Sent as the last message related to a specific task. Error may be nil, which implies that no error occurred and this task is complete.

URLSessionTaskDidFinishCollectingMetrics

default void URLSessionTaskDidFinishCollectingMetrics(@NotNull
                                                      @NotNull NSURLSession session,
                                                      @NotNull
                                                      @NotNull NSURLSessionTask task,
                                                      @NotNull
                                                      @NotNull NSURLSessionTaskMetrics metrics)

Sent when complete statistics information has been collected for the task. API-Since: 10.0

URLSessionTaskDidReceiveChallengeCompletionHandler

default void URLSessionTaskDidReceiveChallengeCompletionHandler(@NotNull
                                                                @NotNull NSURLSession session,
                                                                @NotNull
                                                                @NotNull NSURLSessionTask task,
                                                                @NotNull
                                                                @NotNull NSURLAuthenticationChallenge challenge,
                                                                @NotNull
                                                                @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskDidReceiveChallengeCompletionHandler completionHandler)

The task has received a request specific authentication challenge. If this delegate is not implemented, the session specific authentication challenge will *NOT* be called and the behavior will be the same as using the default handling disposition.

URLSessionTaskDidSendBodyDataTotalBytesSentTotalBytesExpectedToSend

default void URLSessionTaskDidSendBodyDataTotalBytesSentTotalBytesExpectedToSend(@NotNull
                                                                                 @NotNull NSURLSession session,
                                                                                 @NotNull
                                                                                 @NotNull NSURLSessionTask task,
                                                                                 long bytesSent,
                                                                                 long totalBytesSent,
                                                                                 long totalBytesExpectedToSend)

Sent periodically to notify the delegate of upload progress. This information is also available as properties of the task.

URLSessionTaskNeedNewBodyStream

default void URLSessionTaskNeedNewBodyStream(@NotNull
                                             @NotNull NSURLSession session,
                                             @NotNull
                                             @NotNull NSURLSessionTask task,
                                             @NotNull
                                             @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskNeedNewBodyStream completionHandler)

Sent if a task requires a new, unopened body stream. This may be necessary when authentication has failed for any request that involves a body stream.

URLSessionTaskWillPerformHTTPRedirectionNewRequestCompletionHandler

default void URLSessionTaskWillPerformHTTPRedirectionNewRequestCompletionHandler(@NotNull
                                                                                 @NotNull NSURLSession session,
                                                                                 @NotNull
                                                                                 @NotNull NSURLSessionTask task,
                                                                                 @NotNull
                                                                                 @NotNull NSHTTPURLResponse response,
                                                                                 @NotNull
                                                                                 @NotNull NSURLRequest request,
                                                                                 @NotNull
                                                                                 @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskWillPerformHTTPRedirectionNewRequestCompletionHandler completionHandler)

An HTTP request is attempting to perform a redirection to a different URL. You must invoke the completion routine to allow the redirection, allow the redirection with a modified request, or pass nil to the completionHandler to cause the body of the redirection response to be delivered as the payload of this request. The default is to follow redirections. For tasks in background sessions, redirections will always be followed and this method will not be called.

URLSessionTaskWillBeginDelayedRequestCompletionHandler
```
default void URLSessionTaskWillBeginDelayedRequestCompletionHandler(@NotNull
                                                                    @NotNull NSURLSession session,
                                                                    @NotNull
                                                                    @NotNull NSURLSessionTask task,
                                                                    @NotNull
                                                                    @NotNull NSURLRequest request,
                                                                    @NotNull
                                                                    @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskWillBeginDelayedRequestCompletionHandler completionHandler)
```
Sent when the system is ready to begin work for a task with a delayed start time set (using the earliestBeginDate property). The completionHandler must be invoked in order for loading to proceed. The disposition provided to the completion handler continues the load with the original request provided to the task, replaces the request with the specified task, or cancels the task. If this delegate is not implemented, loading will proceed with the original request. Recommendation: only implement this delegate if tasks that have the earliestBeginDate property set may become stale and require alteration prior to starting the network load. If a new request is specified, the allowsExpensiveNetworkAccess, allowsConstrainedNetworkAccess, and allowsCellularAccess properties from the new request will not be used; the properties from the original request will continue to be used. Canceling the task is equivalent to calling the task's cancel method; the URLSession:task:didCompleteWithError: task delegate will be called with error NSURLErrorCancelled. API-Since: 11.0

URLSessionTaskIsWaitingForConnectivity
```
default void URLSessionTaskIsWaitingForConnectivity(@NotNull
                                                    @NotNull NSURLSession session,
                                                    @NotNull
                                                    @NotNull NSURLSessionTask task)
```
Sent when a task cannot start the network loading process because the current network connectivity is not available or sufficient for the task's request. This delegate will be called at most one time per task, and is only called if the waitsForConnectivity property in the NSURLSessionConfiguration has been set to YES. This delegate callback will never be called for background sessions, because the waitForConnectivity property is ignored by those sessions. API-Since: 11.0

URLSessionDidCreateTask
```
default void URLSessionDidCreateTask(@NotNull
                                     @NotNull NSURLSession session,
                                     @NotNull
                                     @NotNull NSURLSessionTask task)
```
Notification that a task has been created. This method is the first message a task sends, providing a place to configure the task before it is resumed. This delegate callback is *NOT* dispatched to the delegate queue. It is invoked synchronously before the task creation method returns. API-Since: 16.0

URLSessionTaskDidReceiveInformationalResponse

default void URLSessionTaskDidReceiveInformationalResponse(@NotNull
                                                           @NotNull NSURLSession session,
                                                           @NotNull
                                                           @NotNull NSURLSessionTask task,
                                                           @NotNull
                                                           @NotNull NSHTTPURLResponse response)

Sent for each informational response received except 101 switching protocols. API-Since: 17.0

URLSessionTaskNeedNewBodyStreamFromOffsetCompletionHandler

default void URLSessionTaskNeedNewBodyStreamFromOffsetCompletionHandler(@NotNull
                                                                        @NotNull NSURLSession session,
                                                                        @NotNull
                                                                        @NotNull NSURLSessionTask task,
                                                                        long offset,
                                                                        @NotNull
                                                                        @NotNull NSURLSessionTaskDelegate.Block_URLSessionTaskNeedNewBodyStreamFromOffsetCompletionHandler completionHandler)

Tells the delegate if a task requires a new body stream starting from the given offset. This may be necessary when resuming a failed upload task. - Parameter session: The session containing the task that needs a new body stream from the given offset. - Parameter task: The task that needs a new body stream. - Parameter offset: The starting offset required for the body stream. - Parameter completionHandler: A completion handler that your delegate method should call with the new body stream. API-Since: 17.0

Interface NSURLSessionTaskDelegate

Nested Class Summary

Nested classes/interfaces inherited from interface apple.foundation.protocol.NSURLSessionDelegate