WebKitWebDatabase

WebKitWebDatabase — A WebKit web application database

Synopsis

                    WebKitWebDatabase;
const gchar *       webkit_web_database_get_display_name
                                                        (WebKitWebDatabase *webDatabase);
guint64             webkit_web_database_get_expected_size
                                                        (WebKitWebDatabase *webDatabase);
const gchar *       webkit_web_database_get_filename    (WebKitWebDatabase *webDatabase);
const gchar *       webkit_web_database_get_name        (WebKitWebDatabase *webDatabase);
WebKitSecurityOrigin * webkit_web_database_get_security_origin
                                                        (WebKitWebDatabase *webDatabase);
guint64             webkit_web_database_get_size        (WebKitWebDatabase *webDatabase);
void                webkit_web_database_remove          (WebKitWebDatabase *webDatabase);

Object Hierarchy

  GObject
   +----WebKitWebDatabase

Properties

  "display-name"             gchar*                : Read
  "expected-size"            guint64               : Read
  "filename"                 gchar*                : Read
  "name"                     gchar*                : Read / Write / Construct Only
  "security-origin"          WebKitSecurityOrigin*  : Read / Write / Construct Only
  "size"                     guint64               : Read

Description

WebKitIconDatabase provides access to website icons, as shown in tab labels, window captions or bookmarks. All views share the same icon database.

The icon database is enabled by default and stored in ~/.local/share/webkit/icondatabase, depending on XDG_DATA_HOME.

WebKit will automatically look for available icons in link elements on opened pages as well as an existing favicon.ico and load the images found into the memory cache if possible. The signal "icon-loaded" will be emitted when any icon is found and loaded. Old Icons are automatically cleaned up after 4 days.

webkit_icon_database_set_path() can be used to change the location of the database and also to disable it by passing NULL.

If WebKitWebSettings::enable-private-browsing is TRUE new icons won't be added to the database on disk and no existing icons will be deleted from it.

Details

WebKitWebDatabase

typedef struct _WebKitWebDatabase WebKitWebDatabase;


webkit_web_database_get_display_name ()

const gchar *       webkit_web_database_get_display_name
                                                        (WebKitWebDatabase *webDatabase);

Returns the name of the WebKitWebDatabase as seen by the user.

webDatabase :

a WebKitWebDatabase

Returns :

the name of the database as seen by the user.

Since 1.1.14


webkit_web_database_get_expected_size ()

guint64             webkit_web_database_get_expected_size
                                                        (WebKitWebDatabase *webDatabase);

Returns the expected size of the WebKitWebDatabase in bytes as defined by the web author. The Web Database standard allows web authors to specify an expected size of the database to optimize the user experience.

webDatabase :

a WebKitWebDatabase

Returns :

the expected size of the database in bytes

Since 1.1.14


webkit_web_database_get_filename ()

const gchar *       webkit_web_database_get_filename    (WebKitWebDatabase *webDatabase);

Returns the absolute filename to the WebKitWebDatabase file on disk.

webDatabase :

a WebKitWebDatabase

Returns :

the absolute filename of the database

Since 1.1.14


webkit_web_database_get_name ()

const gchar *       webkit_web_database_get_name        (WebKitWebDatabase *webDatabase);

Returns the canonical name of the WebKitWebDatabase.

webDatabase :

a WebKitWebDatabase

Returns :

the name of the database

Since 1.1.14


webkit_web_database_get_security_origin ()

WebKitSecurityOrigin * webkit_web_database_get_security_origin
                                                        (WebKitWebDatabase *webDatabase);

Returns the security origin of the WebKitWebDatabase.

webDatabase :

a WebKitWebDatabase

Returns :

the security origin of the database. [transfer none]

Since 1.1.14


webkit_web_database_get_size ()

guint64             webkit_web_database_get_size        (WebKitWebDatabase *webDatabase);

Returns the actual size of the WebKitWebDatabase space on disk in bytes.

webDatabase :

a WebKitWebDatabase

Returns :

the actual size of the database in bytes

Since 1.1.14


webkit_web_database_remove ()

void                webkit_web_database_remove          (WebKitWebDatabase *webDatabase);

Removes the WebKitWebDatabase from its security origin and destroys all data stored in the database.

webDatabase :

a WebKitWebDatabase

Since 1.1.14

Property Details

The "display-name" property

  "display-name"             gchar*                : Read

The display name of the Web Database database.

Default value: NULL

Since 1.1.14


The "expected-size" property

  "expected-size"            guint64               : Read

The expected size of the database in bytes as defined by the web author.

Default value: 0

Since 1.1.14


The "filename" property

  "filename"                 gchar*                : Read

The absolute filename of the Web Database database.

Default value: NULL

Since 1.1.14


The "name" property

  "name"                     gchar*                : Read / Write / Construct Only

The name of the Web Database database.

Default value: NULL

Since 1.1.14


The "security-origin" property

  "security-origin"          WebKitSecurityOrigin*  : Read / Write / Construct Only

The security origin of the database.

Since 1.1.14


The "size" property

  "size"                     guint64               : Read

The current size of the database in bytes.

Default value: 0

Since 1.1.14