WebKit2 – 4.0
Description: Reference for WebKit2-4.0

### Namespace

# WebKit2 – 4.0

The WebKit library

Version | 2.46.4
Authors | The WebKit GTK and WPE teams
License | BSD, LGPL-2.1
Website | https://webkit.org
Source |

#### Build

C headers | `webkit2/webkit2.h`
pkg-config files | `webkit2gtk-4.0`

#### Dependencies

GObject—2.0 | The base type system library
| Browse documentation
Gio—2.0 | GObject Interfaces and Objects, Networking, IPC, and I/O
| Browse documentation
Gtk—3.0 | The GTK widget toolkit
| Browse documentation
Soup—2.4 | HTTP client/server library
| Browse documentation

#### Additional documentation

- Classes Hierarchy

#### Classes

AuthenticationRequest | Represents an authentication request.
AutomationSession | Automation Session. since: 2.18
BackForwardList | List of visited pages.
BackForwardListItem | One item of the `WebKitBackForwardList`.
ClipboardPermissionRequest | A permission request for reading clipboard contents. since: 2.42
ColorChooserRequest | A request to open a color chooser.
ContextMenu | Represents the context menu in a `WebKitWebView`.
ContextMenuItem | One item of a `WebKitContextMenu`.
CookieManager | Defines how to handle cookies in a `WebKitWebContext`.
DeviceInfoPermissionRequest | A permission request for accessing user’s audio/video devices. since: 2.24
Download | Object used to communicate with the application when downloading.
EditorState | Web editor state. since: 2.10
FaviconDatabase | Provides access to the icons associated with web sites.
FileChooserRequest | A request to open a file chooser.
FindController | Controls text search in a `WebKitWebView`.
FormSubmissionRequest | Represents a form submission request.
GeolocationManager | Geolocation manager. since: 2.26
GeolocationPermissionRequest | A permission request for sharing the user’s location.
HitTestResult | Result of a Hit Test.
InputMethodContext | Base class for input method contexts. since: 2.28
InstallMissingMediaPluginsPermissionRequest | Previously, a permission request for installing missing media plugins. deprecated: 2.40 since: 2.10
MediaKeySystemPermissionRequest | A permission request for using an EME Content Decryption Module.
NavigationPolicyDecision | A policy decision for navigation actions.
Notification | Holds information about a notification that should be shown to the user. since: 2.8
NotificationPermissionRequest | A permission request for displaying web notifications. since: 2.8
OptionMenu | Represents the dropdown menu of a `select` element in a `WebKitWebView`. since: 2.18
Plugin | Represents a plugin, enabling fine-grained control. deprecated: 2.32
PointerLockPermissionRequest | A permission request for locking the pointer. since: 2.28
PolicyDecision | A pending policy decision.
PrintCustomWidget | Allows to embed a custom widget in print dialog. deprecated: 2.40 since: 2.16
PrintOperation | Controls a print operation.
ResponsePolicyDecision | A policy decision for resource responses.
SecurityManager | Controls security settings in a `WebKitWebContext`.
Settings | Control the behaviour of a `WebKitWebView`.
URIRequest | Represents a URI request.
URIResponse | Represents an URI response.
URISchemeRequest | Represents a URI scheme request.
URISchemeResponse | Represents a URI scheme response.
UserContentFilterStore | Handles storage of user content filters on disk. since: 2.24
UserContentManager | Manages user-defined content which affects web pages. since: 2.6
UserMediaPermissionRequest | A permission request for accessing user’s audio/video devices. since: 2.8
UserMessage | Message that can be sent between the UI process and web process extensions. since: 2.28
WebContext | Manages aspects common to all `WebKitWebView`s.
WebInspector | Access to the WebKit inspector.
WebResource | Represents a resource at the end of a URI.
WebsiteDataAccessPermissionRequest | A permission request for accessing website data from third-party domains. since: 2.30
WebsiteDataManager | Manages data stored locally by web sites. since: 2.10
WebsitePolicies | View specific website policies. since: 2.30
WebView | The central class of the WPE WebKit and WebKitGTK APIs.
WebViewBase |
WindowProperties | Window properties of a `WebKitWebView`.

#### Interfaces

PermissionRequest | A permission request.

#### Structs

ApplicationInfo | Information about an application running in automation mode.
Credential | Groups information used for user authentication. since: 2.2
Feature | Describes a web engine feature that may be toggled at runtime. since: 2.42
FeatureList | Contains a set of toggle-able web engine features. since: 2.42
GeolocationPosition | An opaque struct to provide position updates to a `WebKitGeolocationManager`. since: 2.26
InputMethodUnderline | Range of text in an preedit string to be shown underlined. since: 2.28
ITPFirstParty | Describes a first party origin. since: 2.30
ITPThirdParty | Describes a third party origin. since: 2.30
JavascriptResult | Result of JavaScript evaluation in a web view.
MemoryPressureSettings | A boxed type representing the settings for the memory pressure handler. since: 2.34
MimeInfo | Information about a MIME type.
NavigationAction | Provides details about interaction resulting in a resource load.
NetworkProxySettings | Configures network proxies. since: 2.16
OptionMenuItem | One item of a `WebKitOptionMenu`. since: 2.18
PermissionStateQuery | This query represents a user’s choice to allow or deny access to “powerful features” of the platform, as specified in the Permissions W3C Specification.
ScriptDialog | Carries details to be shown in user-facing dialogs.
ScriptMessageReply | A reply for a script message received. If no reply has been sent by the user, an automatically generated reply with undefined value with be sent. since: 2.40
SecurityOrigin | A security boundary for websites. since: 2.16
UserContentFilter | A compiled set of rules which applied to resource loads. since: 2.24
UserScript | A JavaScript snippet which can be injected in loaded pages. since: 2.6
UserStyleSheet | A CSS style sheet which can be injected in loaded pages. since: 2.6
WebsiteData | Data stored locally by a web site. since: 2.16
WebViewSessionState | Handles serialization of a web view’s browsing state. since: 2.12

#### Enumerations

AuthenticationScheme | Enum values representing the authentication scheme. since: 2.2
AutomationBrowsingContextPresentation | Enum values used for determining the automation browsing context presentation. since: 2.28
AutoplayPolicy | Enum values used to specify autoplay policies. since: 2.30
CacheModel | Enum values used for determining the `WebKitWebContext` cache model.
ContextMenuAction | Enum values used to denote the stock actions for `WebKitContextMenuItem`s.
CookieAcceptPolicy | Enum values used to denote the cookie acceptance policies.
CookiePersistentStorage | Enum values used to denote the cookie persistent storage types.
CredentialPersistence | Enum values representing the duration for which a credential persists. since: 2.2
FeatureStatus | Describes the status of a `WebKitFeature`. since: 2.42
HardwareAccelerationPolicy | Enum values used for determining the hardware acceleration policy. since: 2.16
InputPurpose | Enum values used to describe the primary purpose of the active editable element. since: 2.28
InsecureContentEvent | Enum values previously used to denote the different events which can trigger the detection of insecure content. Since 2.46, WebKit generally no longer loads insecure content in secure contexts. deprecated: 2.46
LoadEvent | Enum values used to denote the different events that happen during a `WebKitWebView` load operation.
MediaCaptureState | Enum values used to specify the capture state of a media device. since: 2.34
NavigationType | Enum values used to denote the various navigation types.
NetworkProxyMode | Enum values used to set the network proxy mode. since: 2.16
PermissionState | Enum values representing query permission results. since: 2.40
PolicyDecisionType | Enum values used for determining the type of a policy decision during `WebKitWebView::decide-policy`.
PrintOperationResponse | Enum values representing the response of the print dialog shown with webkit_print_operation_run_dialog().
ProcessModel | Enum values used for determining the `WebKitWebContext` process model. deprecated: 2.40 since: 2.4
SaveMode | Enum values to specify the different ways in which a `WebKitWebView` can save its current web page into a self-contained file.
ScriptDialogType | Enum values used for determining the type of `WebKitScriptDialog`.
SnapshotRegion | Enum values used to specify the region from which to get a `WebKitWebView` snapshot.
TLSErrorsPolicy | Enum values used to denote the TLS errors policy.
UserContentInjectedFrames | Specifies in which frames user style sheets are to be inserted in. since: 2.6
UserScriptInjectionTime | Specifies at which place of documents an user script will be inserted. since: 2.6
UserStyleLevel | Specifies how to treat an user style sheet. since: 2.6
WebExtensionMode | Enum values used for setting if a `WebKitWebView` is intended for WebExtensions. since: 2.38
WebProcessTerminationReason | Enum values used to specify the reason why the web process terminated abnormally. since: 2.20

#### Bitfields

EditorTypingAttributes | Enum values with flags representing typing attributes. since: 2.10
FindOptions | Enum values used to specify search options.
HitTestResultContext | Enum values with flags representing the context of a `WebKitHitTestResult`.
InputHints | Enum values used to describe hints that might be taken into account by input methods. since: 2.28
SnapshotOptions | Enum values used to specify options when taking a snapshot from a `WebKitWebView`.
WebsiteDataTypes | Enum values with flags representing types of Website data. since: 2.16

#### Error Domains

DownloadError | Enum values used to denote the various download errors.
FaviconDatabaseError | Enum values used to denote the various errors related to the `WebKitFaviconDatabase`.
JavascriptError | Enum values used to denote errors happening when executing JavaScript.
NetworkError | Enum values used to denote the various network errors.
PluginError | Enum values used to denote the various plugin and media errors.
PolicyError | Enum values used to denote the various policy errors.
PrintError | Enum values used to denote the various print errors.
SnapshotError | Enum values used to denote errors happening when creating snapshots of `WebKitWebView`.
UserContentFilterError | Errors that can occur while compiling content filters. since: 2.24
UserMessageError | Enum values used to denote errors happening when sending user messages. since: 2.28

#### Callbacks

URISchemeRequestCallback | Type definition for a function that will be called back when an URI request is made for a user registered URI scheme.

#### Functions

get_major_version | Returns the major version number of the WebKit library.
get_micro_version | Returns the micro version number of the WebKit library.
get_minor_version | Returns the minor version number of the WebKit library.
media_key_system_permission_get_name | Get the key system for which access permission is being requested. since: 2.32
uri_for_display | Use this function to format a URI for display. since: 2.24
user_media_permission_is_for_audio_device | Check whether the permission request is for an audio device. since: 2.8
user_media_permission_is_for_display_device | Check whether the permission request is for a display device. since: 2.34
user_media_permission_is_for_video_device | Check whether the permission request is for a video device. since: 2.8

#### Function Macros

CHECK_VERSION | Check the version of the WebKit headers at compilation time.
DECLARE_TYPE |
DEPRECATED_FOR | Marks a symbol as deprecated, indicating a replacement.
URI_REQUEST |
URI_REQUEST_CLASS |
URI_RESPONSE |
URI_RESPONSE_CLASS |
URI_SCHEME_REQUEST |
URI_SCHEME_REQUEST_CLASS |
URI_SCHEME_RESPONSE |
URI_SCHEME_RESPONSE_CLASS |

#### Constants

EDITING_COMMAND_COPY | The copy clipboard command. Copies the current selection inside a `WebKitWebView` to the clipboard. You can check whether it’s possible to execute the command with webkit_web_view_can_execute_editing_command(). In general it’s possible to copy to the clipboard when there is an active selection inside the `WebKitWebView`.
EDITING_COMMAND_CREATE_LINK | The create link command. Creates a link element that is inserted at the current cursor position. If there’s a selection, the selected text will be used as the link text, otherwise the URL itself will be used. It receives the link URL as argument. This command should be executed with webkit_web_view_execute_editing_command_with_argument().
EDITING_COMMAND_CUT | The cut clipboard command. Copies the current selection inside a `WebKitWebView` to the clipboard and deletes the selected content. You can check whether it’s possible to execute the command with webkit_web_view_can_execute_editing_command(). In general it’s possible to cut to the clipboard when the `WebKitWebView` content is editable and there is an active selection.
EDITING_COMMAND_INSERT_IMAGE | The insert image command. Creates an image element that is inserted at the current cursor position. It receives an URI as argument, that is used as the image source. This command should be executed with webkit_web_view_execute_editing_command_with_argument().
EDITING_COMMAND_PASTE | The paste clipboard command. Pastes the contents of the clipboard to a `WebKitWebView`. You can check whether it’s possible to execute the command with webkit_web_view_can_execute_editing_command(). In general it’s possible to paste from the clipboard when the `WebKitWebView` content is editable and clipboard is not empty.
EDITING_COMMAND_PASTE_AS_PLAIN_TEXT | The paste as plaintext clipboard command. Pastes the contents of the clipboard to a `WebKitWebView`, with formatting removed. You can check whether it’s possible to execute the command with webkit_web_view_can_execute_editing_command(). In general it’s possible to paste from the clipboard when the `WebKitWebView` content is editable and clipboard is not empty.
EDITING_COMMAND_REDO | The redo command. Redoes a previously undone editing command in a `WebKitWebView`. You can check whether it’s possible to execute the command with webkit_web_view_can_execute_editing_command(). It’s only possible to redo a command when it has been previously undone.
EDITING_COMMAND_SELECT_ALL | The select all command. Selects all the content of the current text field in a `WebKitWebView`. It is always possible to select all text, no matter whether the `WebKitWebView` content is editable or not. You can still check it with webkit_web_view_can_execute_editing_command().
EDITING_COMMAND_UNDO | The undo command. Undoes the last editing command in a `WebKitWebView`. You can check whether it’s possible to execute the command with webkit_web_view_can_execute_editing_command(). It’s only possible to undo a command after a previously executed editing operation.
MAJOR_VERSION | Like webkit_get_major_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
MICRO_VERSION | Like webkit_get_micro_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.
MINOR_VERSION | Like webkit_get_minor_version(), but from the headers used at application compile time, rather than from the library linked against at application run time.