<!--
{
  "availability" : [
    "macCatalyst: -",
    "macOS: 10.0.0 - 10.4.0"
  ],
  "documentType" : "symbol",
  "framework" : "Foundation",
  "identifier" : "/documentation/Foundation/NSURLHandleClient",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Foundation"
    ],
    "preciseIdentifier" : "c:objc(pl)NSURLHandleClient"
  },
  "title" : "NSURLHandleClient"
}
-->

# NSURLHandleClient

The interface implemented by URL handle clients.

```
@protocol NSURLHandleClient
```

## Overview

[`NSURLHandleClient`](/documentation/Foundation/NSURLHandleClient) is deprecated in macOS 10.4 and later. Applications that are intended for deployment in macOS 10.3 or later should use [`NSURLConnection`](/documentation/Foundation/NSURLConnection) or [`NSURLDownload`](/documentation/Foundation/NSURLDownload) instead; see [URL Loading System](/documentation/Foundation/url-loading-system).

## Topics

### Notification methods

[`-  URLHandleResourceDidBeginLoading:`](/documentation/Foundation/NSURLHandleClient/URLHandleResourceDidBeginLoading:)

Sent when an URL handle begins loading resource data.

[`-  URLHandleResourceDidCancelLoading:`](/documentation/Foundation/NSURLHandleClient/URLHandleResourceDidCancelLoading:)

Sent when an URL handle has canceled loading resource data in response to a programmatic request.

[`-  URLHandleResourceDidFinishLoading:`](/documentation/Foundation/NSURLHandleClient/URLHandleResourceDidFinishLoading:)

Sent when an URL handle finishes loading resource data.

[`-  URLHandle:resourceDataDidBecomeAvailable:`](/documentation/Foundation/NSURLHandleClient/URLHandle:resourceDataDidBecomeAvailable:)

Sent periodically by an URL handle when new resource data becomes available.

[`-  URLHandle:resourceDidFailLoadingWithReason:`](/documentation/Foundation/NSURLHandleClient/URLHandle:resourceDidFailLoadingWithReason:)

Sent when the URL handle failed to load resource data for some reason other than being canceled.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)