SoupCookieJarAcceptPolicy

The policy for accepting or rejecting cookies returned in responses.

Values

ValueMeaning
ALWAYS0

accept all cookies unconditionally.

NEVER1

reject all cookies unconditionally.

NO_THIRD_PARTY2

accept all cookies set by the main document loaded in the application using libsoup. An example of the most common case, web browsers, would be: If http://www.example.com is the page loaded, accept all cookies set by example.com, but if a resource from http://www.third-party.com is loaded from that page reject any cookie that it could try to set. For libsoup to be able to tell apart first party cookies from the rest, the application must call soup_message_set_first_party() on each outgoing #SoupMessage, setting the #SoupURI of the main document. If no first party is set in a message when this policy is in effect, cookies will be assumed to be third party by default.

GRANDFATHERED_THIRD_PARTY3

accept all cookies set by the main document loaded in the application using libsoup, and from domains that have previously set at least one cookie when loaded as the main document. An example of the most common case, web browsers, would be: if http://www.example.com is the page loaded, accept all cookies set by example.com, but if a resource from http://www.third-party.com is loaded from that page, reject any cookie that it could try to set unless it already has a cookie in the cookie jar. For libsoup to be able to tell apart first party cookies from the rest, the application must call soup_message_set_first_party() on each outgoing #SoupMessage, setting the #SoupURI of the main document. If no first party is set in a message when this policy is in effect, cookies will be assumed to be third party by default. Since 2.72.

Meta

Since

2.30