Instance Method インスタンスメソッド

setCookies(_:for:mainDocumentURL:)

Adds an array of cookies to the cookie storage if the storage’s cookie acceptance policy permits. クッキーの配列をクッキーストレージに加えます、もしそのストレージの持つクッキー受入方針が許可するならば。

Declaration 宣言 

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

Parameters パラメータ

cookies

The cookies to add. このクッキーを加えます。

theURL

The URL associated with the added cookies. 加えられるクッキーと結び付けられているURL。

mainDocumentURL

The URL of the main HTML document for the top-level frame, if known. The value can be nil. This URL is used to determine whether the cookie should be accepted if the cookie accept policy is HTTPCookie.AcceptPolicy.onlyFromMainDocumentDomain. トップレベルフレームに対するメインHTMLドキュメントのURL、もし知られるならば。値はnilであることができます。このURLは、クッキーが受け入れられるべきかどうか決定するために使われます、もしクッキー受入方針がHTTPCookie.AcceptPolicy.onlyFromMainDocumentDomainであるならば。

Discussion 議論

Cookies in the array will replace existing cookies with the same name, domain, and path in the cookie storage. If the storage has an accept policy of HTTPCookie.AcceptPolicy.never, the cookies are ignored. 配列の中のクッキーは、同じ名前、ドメイン、そしてパスをクッキーストレージにおいて持つ既存のクッキーを置き換えるでしょう。ストレージがHTTPCookie.AcceptPolicy.neverの受入方針を持つならば、そのクッキーは無視されます。

To store cookies from a set of response headers, an application can use cookies(withResponseHeaderFields:for:) passing a header field dictionary and then use this method to store the resulting cookies in accordance with the cookie storage’s cookie acceptance policy. 一揃いのレスポンスヘッダからクッキーを貯蔵するには、アプリケーションはcookies(withResponseHeaderFields:for:)をヘッダフィールド辞書を渡して使用して、それからこのメソッドを使って結果のクッキーをクッキーストレージの持つクッキー受入方針に従って貯蔵できます。

If you override this method, also override storeCookies(_:for:). あなたがこのメソッドをオーバーライドするならば、またstoreCookies(_:for:)もオーバーライドしてください。

See Also 参照

Adding and Removing Cookies クッキーの追加と除去

func removeCookies(since: Date)
Removes cookies that were stored after a given date. 与えられた日付より後に貯蔵されたクッキーを取り除きます。
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 storeCookies([HTTPCookie], for: URLSessionTask)
Stores an array of cookies in the cookie storage, on behalf of the provided task, if the cookie accept policy permits. クッキーの配列をクッキーストレージの中に貯蔵します、提供されたタスクの代理で、もしクッキー受入方針が許可するならば。