Instance Property


A copy of the configuration object for this session.


@property(readonly, copy) NSURLSessionConfiguration *configuration;


Beginning in iOS 9 and OS X 10.11, NSURLSession objects store a copy of the NSURLSessionConfiguration object passed to their initializers, such that a session’s configuration is immutable after initialization. Any further changes to mutable properties on the configuration object passed to a session’s initializer or the value returned from a session’s configuration property do not affect the behavior of that session. However, you can create a new session with the modified configuration object.

See Also

Creating a Session

+ sessionWithConfiguration:

Creates a session with the specified session configuration.

+ sessionWithConfiguration:delegate:delegateQueue:

Creates a session with the specified session configuration, delegate, and operation queue.


A configuration object that defines behavior and policies for a URL session.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software