WebKit.WebsiteDataManager – webkit2gtk-4.0

Description:

[ CCode ( type_id = "webkit_website_data_manager_get_type ()" ) ]
[ Version ( since = "2.10" ) ]
public class WebsiteDataManager : Object

Manages data stored locally by web sites.

WebKitWebsiteDataManager allows you to manage the data that websites can store in the client file system like databases or caches. You can use WebKitWebsiteDataManager to configure the local directories where the Website data will be stored, by creating a new manager with WebsiteDataManager passing the values you want to set. You can set all the possible configuration values or only some of them, a default value will be used automatically for the configuration options not provided. base_data_directory and base_cache_directory are two special properties that can be used to set a common base directory for all Website data and caches. It's possible to provide both, a base directory and a specific value, but in that case, the specific value takes precedence over the base directory. The newly created WebKitWebsiteDataManager must be passed as a construct property to a WebContext, you can use WebContext.with_website_data_manager to create a new WebContext with a WebKitWebsiteDataManager. In case you don't want to set any specific configuration, you don't need to create a WebKitWebsiteDataManager, the WebContext will create a WebKitWebsiteDataManager with the default configuration. To get the WebKitWebsiteDataManager of a WebContext you can use get_website_data_manager.

A WebKitWebsiteDataManager can also be ephemeral and then all the directories configuration is not needed because website data will never persist. You can create an ephemeral WebKitWebsiteDataManager with WebsiteDataManager.ephemeral. Then you can pass an ephemeral WebKitWebsiteDataManager to a WebContext to make it ephemeral or use WebContext.ephemeral and the WebKitWebsiteDataManager will be automatically created by the WebContext.

WebKitWebsiteDataManager can also be used to fetch websites data, remove data stored by particular websites, or clear data for all websites modified since a given period of time.

Namespace: WebKit

Content:

Properties:

public string base_cache_directory { get; construct; }

The base directory for Website cache.

public string base_data_directory { get; construct; }

The base directory for Website data.

public string disk_cache_directory { get; construct; }

The directory where HTTP disk cache will be stored.

public string dom_cache_directory { get; construct; }

The directory where DOM cache will be stored.

public string hsts_cache_directory { get; construct; }

The directory where the HTTP Strict-Transport-Security (HSTS) cache will be stored.

public string indexeddb_directory { get; construct; }

The directory where IndexedDB databases will be stored.

public bool is_ephemeral { get; construct; }

Whether the WebsiteDataManager is ephemeral.

public string itp_directory { get; construct; }

The directory where Intelligent Tracking Prevention (ITP) data will be stored.

public string local_storage_directory { get; construct; }

The directory where local storage data will be stored.

public string offline_application_cache_directory { get; construct; }

The directory where offline web application cache will be stored.

public string service_worker_registrations_directory { get; construct; }

The directory where service workers registrations will be stored.

public string websql_directory { get; construct; }

The directory where WebSQL databases will be stored.

Static methods:

Creation methods:

protected WebsiteDataManager ()

Creates a new WebsiteDataManager with the given options.

public WebsiteDataManager.ephemeral ()

Creates an ephemeral WebsiteDataManager.

Methods:

public async bool clear (WebsiteDataTypes types, TimeSpan timespan, Cancellable? cancellable = null) throws Error

Asynchronously clear the website data of the given types modified in the past timespan.

public async List<WebsiteData> fetch (WebsiteDataTypes types, Cancellable? cancellable = null) throws Error

Asynchronously get the list of WebsiteData for the given types.

public unowned string? get_base_cache_directory ()

Get the base_cache_directory property.

public unowned string? get_base_data_directory ()

Get the base_data_directory property.

public unowned CookieManager get_cookie_manager ()

Get the CookieManager of this.

public unowned string? get_disk_cache_directory ()

Get the disk_cache_directory property.

public unowned string? get_dom_cache_directory ()

Get the dom_cache_directory property.

public unowned string? get_hsts_cache_directory ()

Get the hsts_cache_directory property.

public unowned string? get_indexeddb_directory ()

Get the indexeddb_directory property.

public unowned string? get_itp_directory ()

Get the itp_directory property.

public bool get_itp_enabled ()

Get whether Intelligent Tracking Prevention (ITP) is enabled or not.

public async List<ITPThirdParty> get_itp_summary (Cancellable? cancellable = null) throws Error

Asynchronously get the list of ITPThirdParty seen for this.

public unowned string? get_local_storage_directory ()

Get the local_storage_directory property.

public unowned string? get_offline_application_cache_directory ()

Get the offline_application_cache_directory property.

public bool get_persistent_credential_storage_enabled ()

Get whether persistent credential storage is enabled or not.

public unowned string? get_service_worker_registrations_directory ()

Get the service_worker_registrations_directory property.

public TLSErrorsPolicy get_tls_errors_policy ()

Get the TLS errors policy of this.

public unowned string? get_websql_directory ()

Get the websql_directory property.

public async bool remove (WebsiteDataTypes types, List<WebsiteData> website_data, Cancellable? cancellable = null) throws Error

Asynchronously removes the website data in the given


									website_data

list.

public void set_itp_enabled (bool enabled)

Enable or disable Intelligent Tracking Prevention (ITP).

public void set_network_proxy_settings (NetworkProxyMode proxy_mode, NetworkProxySettings? proxy_settings)

Set the network proxy settings to be used by connections started in this session.

public void set_persistent_credential_storage_enabled (bool enabled)

Enable or disable persistent credential storage.

public void set_tls_errors_policy (TLSErrorsPolicy policy)

Set the TLS errors policy of this as policy.

Inherited Members:

All known members inherited from class GLib.Object

@get
@new
@ref
@set
add_toggle_ref
add_weak_pointer
bind_property
connect
constructed
disconnect
dispose
dup_data
dup_qdata
force_floating
freeze_notify
get_class
get_data

get_property
get_qdata
get_type
getv
interface_find_property
interface_install_property
interface_list_properties
is_floating
new_valist
new_with_properties
newv
notify
notify_property
ref_count
ref_sink
remove_toggle_ref
remove_weak_pointer

replace_data
replace_qdata
set_data
set_data_full
set_property
set_qdata
set_qdata_full
set_valist
setv
steal_data
steal_qdata
thaw_notify
unref
watch_closure
weak_ref
weak_unref

WebsiteDataManager