Class
WebKit2CookieManager
Description [src]
class WebKit2.CookieManager : GObject.Object {
parent: GObject
}
Defines how to handle cookies in a WebKitWebContext
.
The WebKitCookieManager defines how to set up and handle cookies.
You can get it from a WebKitWebsiteDataManager
with
webkit_website_data_manager_get_cookie_manager(), and use it to set where to
store cookies with webkit_cookie_manager_set_persistent_storage(),
or to set the acceptance policy, with webkit_cookie_manager_get_accept_policy().
Instance methods
webkit_cookie_manager_add_cookie
Asynchronously add a SoupCookie
to the underlying storage.
Available since: 2.20
webkit_cookie_manager_add_cookie_finish
Finish an asynchronous operation started with webkit_cookie_manager_add_cookie().
Available since: 2.20
webkit_cookie_manager_delete_all_cookies
Delete all cookies of cookie_manager
.
Deprecated since: 2.16
webkit_cookie_manager_delete_cookie
Asynchronously delete a SoupCookie
from the current session.
Available since: 2.20
webkit_cookie_manager_delete_cookie_finish
Finish an asynchronous operation started with webkit_cookie_manager_delete_cookie().
Available since: 2.20
webkit_cookie_manager_delete_cookies_for_domain
Remove all cookies of cookie_manager
for the given domain
.
Deprecated since: 2.16
webkit_cookie_manager_get_accept_policy
Asynchronously get the cookie acceptance policy of cookie_manager
.
Note that when policy was set to WEBKIT_COOKIE_POLICY_ACCEPT_NO_THIRD_PARTY
and
ITP is enabled, this will return WEBKIT_COOKIE_POLICY_ACCEPT_ALWAYS
.
See also webkit_website_data_manager_set_itp_enabled().
webkit_cookie_manager_get_accept_policy_finish
Finish an asynchronous operation started with webkit_cookie_manager_get_accept_policy().
webkit_cookie_manager_get_cookies
Asynchronously get a list of SoupCookie
from cookie_manager
associated with uri
, which
must be either an HTTP or an HTTPS URL.
Available since: 2.20
webkit_cookie_manager_get_cookies_finish
Finish an asynchronous operation started with webkit_cookie_manager_get_cookies().
The return value is a GSList
of SoupCookie
instances which should be released
with g_list_free_full()
and soup_cookie_free().
Available since: 2.20
webkit_cookie_manager_get_domains_with_cookies
Asynchronously get the list of domains for which cookie_manager
contains cookies.
Deprecated since: 2.16
webkit_cookie_manager_get_domains_with_cookies_finish
Finish an asynchronous operation started with webkit_cookie_manager_get_domains_with_cookies().
The return value is a NULL
terminated list of strings which should
be released with g_strfreev().
Deprecated since: 2.16
webkit_cookie_manager_set_accept_policy
Set the cookie acceptance policy of cookie_manager
as policy
.
Note that ITP has its own way to handle third-party cookies, so when it’s enabled,
and policy
is set to WEBKIT_COOKIE_POLICY_ACCEPT_NO_THIRD_PARTY
, WEBKIT_COOKIE_POLICY_ACCEPT_ALWAYS
will be used instead. Once disabled, the policy will be set back to WEBKIT_COOKIE_POLICY_ACCEPT_NO_THIRD_PARTY
.
See also webkit_website_data_manager_set_itp_enabled().
webkit_cookie_manager_set_persistent_storage
Set the filename
where non-session cookies are stored persistently using
storage
as the format to read/write the cookies.
Cookies are initially read from filename
to create an initial set of cookies.
Then, non-session cookies will be written to filename
when the WebKitCookieManager::changed
signal is emitted.
By default, cookie_manager
doesn’t store the cookies persistently, so you need to call this
method to keep cookies saved across sessions.
Signals
WebKit2.CookieManager::changed
This signal is emitted when cookies are added, removed or modified.
Signals inherited from GObject (1)
GObject.Object::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.
Class structure
struct WebKit2CookieManagerClass {
GObjectClass parent_class;
void (* _webkit_reserved0) (
void
);
void (* _webkit_reserved1) (
void
);
void (* _webkit_reserved2) (
void
);
void (* _webkit_reserved3) (
void
);
}
Class members
parent_class |
|
No description available. | |
_webkit_reserved0 |
|
No description available. | |
_webkit_reserved1 |
|
No description available. | |
_webkit_reserved2 |
|
No description available. | |
_webkit_reserved3 |
|
No description available. |