## 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