Class

HTTPCookieStorage

A singleton object (shared instance) that manages storage of cookies.

Overview

Each cookie is represented by an instance of the HTTPCookie class. As a rule, cookies are shared among all applications and are kept in sync across process boundaries. Session cookies (where the cookie object’s isSessionOnly method returns true) are local to a single process and are not shared.

Thread Safety

In macOS 10.9 and later and iOS 7 and later, NSHTTPCookieStorage is thread safe.

Topics

Getting the Shared Cookie Storage Object

Getting and Setting the Cookie Accept Policy

var cookieAcceptPolicy: HTTPCookie.AcceptPolicy

The cookie storage’s cookie accept policy.

Adding and Removing Cookies

func deleteCookie(HTTPCookie)

Deletes the specified cookie from the cookie storage.

func setCookie(HTTPCookie)

Stores a specified cookie in the cookie storage if the cookie accept policy permits.

func setCookies([HTTPCookie], for: URL?, mainDocumentURL: URL?)

Adds an array of cookies to the receiver if the receiver’s cookie acceptance policy permits.

Retrieving Cookies

var cookies: [HTTPCookie]?

The cookie storage’s cookies.

func cookies(for: URL)

Returns all the cookie storage’s cookies that are sent to a specified URL.

func sortedCookies(using: [NSSortDescriptor])

Returns all of the cookie storage’s cookies, sorted according to a given set of sort descriptors.

Constants

enum HTTPCookie.AcceptPolicy

NSHTTPCookieAcceptPolicy specifies the cookie acceptance policies implemented by the NSHTTPCookieStorage class.

Notifications

static let NSHTTPCookieManagerCookiesChanged: NSNotification.Name

This notification is posted when the cookies stored in the NSHTTPCookieStorage instance have changed.

static let NSHTTPCookieManagerAcceptPolicyChanged: NSNotification.Name

This notification is posted when the acceptance policy of the NSHTTPCookieStorage instance has changed.

Relationships

Inherits From

Conforms To

See Also

Cookies

class HTTPCookie

An object that represents an HTTP cookie. It is an immutable object, initialized from a dictionary containing the cookie attributes.