An object that accesses and manages resource data indicated by a URL.


A single NSURLHandle can service multiple equivalent NSURL objects, but only if these URLs map to the same resource.

NSURLHandle is deprecated in macOS 10.4 and later. Applications that are intended for deployment in macOS 10.3 or later should use NSURLConnection or NSURLDownload instead; see URL Session Programming Guide.


Cocoa provides private concrete subclasses to handle HTTP and file URL schemes. If you want to implement support for additional URL schemes, you would do so by creating a subclass of NSURLHandle. You can use NSURL and NSURLHandle to download from FTP sites without subclassing.



enum NSURLHandle.Status

These following constants are defined by NSURLHandle and are returned by status.


Inherits From

Conforms To

See Also

URL Handle

protocol NSURLHandleClient

The interface implemented by URL handle clients.