Soup.Cookie (original) (raw)

Struct

SoupCookie

Description [src]


struct SoupCookie {
  /* No available fields */
}

Implements HTTP cookies, as described byRFC 6265.

To have a SoupSession handle cookies for your appliction automatically, use a SoupCookieJar.

name and value will be set for all cookies. If the cookie is generated from a string that appears to have no name, then namewill be the empty string.

domain and path give the host or domain, and path within that host/domain, to restrict this cookie to. If domain starts with “.”, that indicates a domain (which matches the string after the “.”, or any hostname that has domain as a suffix). Otherwise, it is a hostname and must match exactly.

expires will be non-NULL if the cookie uses either the original “expires” attribute, or the newer “max-age” attribute. If expiresis NULL, it indicates that neither “expires” nor “max-age” was specified, and the cookie expires at the end of the session.

If http_only is set, the cookie should not be exposed to untrusted code (eg, javascript), so as to minimize the danger posed by cross-site scripting attacks.

Constructors

Functions

Instance methods

When used in conjunction withsoup_cookie_jar_get_cookie_list_with_same_site_info() this sets the policy of when this cookie should be exposed.

Serializes cookie in the format used by the Cookie header (ie, for returning a cookie from a SoupSession to a server).