Make a copy of @console_message.
A copy of passed in #WebKitConsoleMessage
a #WebKitConsoleMessage
Free the #WebKitConsoleMessage
a #WebKitConsoleMessage
Gets the log level of a #WebKitConsoleMessage
a #WebKitConsoleMessageLevel indicating the log level of @console_message
a #WebKitConsoleMessage
Gets the line number of a #WebKitConsoleMessage
the line number of @console_message
a #WebKitConsoleMessage
Gets the source of a #WebKitConsoleMessage
a #WebKitConsoleMessageSource indicating the source of @console_message
a #WebKitConsoleMessage
Gets the source identifier of a #WebKitConsoleMessage
the source identifier of @console_message
a #WebKitConsoleMessage
Gets the text message of a #WebKitConsoleMessage
the text message of @console_message
a #WebKitConsoleMessage
Enum values used to denote the various levels of console messages.
Information message.
Log message.
Warning message.
Error message.
Debug message.
Enum values used to denote the various sources of console messages.
Message produced by JavaScript.
Network messages.
Messages produced by console API.
Security messages.
Other messages.
Represents the context menu in a #WebKitWebView.
#WebKitContextMenu represents a context menu containing
#WebKitContextMenuItem<!-- -->s in a #WebKitWebView.
When a #WebKitWebView is about to display the context menu, it
emits the #WebKitWebView::context-menu signal, which has the
#WebKitContextMenu as an argument. You can modify it, adding new
submenus that you can create with webkit_context_menu_new(), adding
new #WebKitContextMenuItem<!-- -->s with
webkit_context_menu_prepend(), webkit_context_menu_append() or
webkit_context_menu_insert(), maybe after having removed the
existing ones with webkit_context_menu_remove_all().
Creates a new #WebKitContextMenu object.
Creates a new #WebKitContextMenu object to be used as a submenu of an existing
#WebKitContextMenu. The context menu of a #WebKitWebView is created by the view
and passed as an argument of #WebKitWebView::context-menu signal.
To add items to the menu use webkit_context_menu_prepend(),
webkit_context_menu_append() or webkit_context_menu_insert().
See also webkit_context_menu_new_with_items() to create a #WebKitContextMenu with
a list of initial items.
The newly created #WebKitContextMenu object
Creates a new #WebKitContextMenu object with the given items.
Creates a new #WebKitContextMenu object to be used as a submenu of an existing
#WebKitContextMenu with the given initial items.
See also webkit_context_menu_new()
The newly created #WebKitContextMenu object
a #GList of #WebKitContextMenuItem
Adds @item at the end of the @menu.
a #WebKitContextMenu
the #WebKitContextMenuItem to add
Gets the first item in the @menu.
the first #WebKitContextMenuItem of @menu,
or %NULL if the #WebKitContextMenu is empty.
a #WebKitContextMenu
Gets the #GdkEvent that triggered the context menu. This function only returns a valid
#GdkEvent when called for a #WebKitContextMenu passed to #WebKitWebView::context-menu
signal; in all other cases, %NULL is returned.
The returned #GdkEvent is expected to be one of the following types:
<itemizedlist>
<listitem><para>
a #GdkEventButton of type %GDK_BUTTON_PRESS when the context menu was triggered with mouse.
</para></listitem>
<listitem><para>
a #GdkEventKey of type %GDK_KEY_PRESS if the keyboard was used to show the menu.
</para></listitem>
<listitem><para>
a generic #GdkEvent of type %GDK_NOTHING when the #GtkWidget::popup-menu signal was used to show the context menu.
</para></listitem>
</itemizedlist>
the menu event or %NULL.
a #WebKitContextMenu
Gets the item at the given position in the @menu.
the #WebKitContextMenuItem at position @position in @menu,
or %NULL if the position is off the end of the @menu.
a #WebKitContextMenu
the position of the item, counting from 0
Returns the item list of @menu.
a #GList of
#WebKitContextMenuItem<!-- -->s
a #WebKitContextMenu
Gets the length of the @menu.
the number of #WebKitContextMenuItem<!-- -->s in @menu
a #WebKitContextMenu
Gets the user data of @menu.
This function can be used from the UI Process to get user data previously set
from the Web Process with webkit_context_menu_set_user_data().
the user data of @menu, or %NULL if @menu doesn't have user data
a #WebKitContextMenu
Inserts @item into the @menu at the given position.
If @position is negative, or is larger than the number of items
in the #WebKitContextMenu, the item is added on to the end of
the @menu. The first position is 0.
a #WebKitContextMenu
the #WebKitContextMenuItem to add
the position to insert the item
Gets the last item in the @menu.
the last #WebKitContextMenuItem of @menu,
or %NULL if the #WebKitContextMenu is empty.
a #WebKitContextMenu
Moves @item to the given position in the @menu.
If @position is negative, or is larger than the number of items
in the #WebKitContextMenu, the item is added on to the end of
the @menu.
The first position is 0.
a #WebKitContextMenu
the #WebKitContextMenuItem to add
the new position to move the item
Adds @item at the beginning of the @menu.
a #WebKitContextMenu
the #WebKitContextMenuItem to add
Removes @item from the @menu.
See also webkit_context_menu_remove_all() to remove all items.
a #WebKitContextMenu
the #WebKitContextMenuItem to remove
Removes all items of the @menu.
a #WebKitContextMenu
Sets user data to @menu.
This function can be used from a Web Process extension to set user data
that can be retrieved from the UI Process using webkit_context_menu_get_user_data().
If the @user_data #GVariant is floating, it is consumed.
a #WebKitContextMenu
a #GVariant
Enum values used to denote the stock actions for
#WebKitContextMenuItem<!-- -->s
No action, used by separator menu items.
Open current link.
Open current link in a new window.
Download link destination.
Copy link location to the clipboard.
Open current image in a new window.
Download current image.
Copy current image to the clipboard.
Copy current image location to the clipboard.
Open current frame in a new window.
Load the previous history item.
Load the next history item.
Stop any ongoing loading operation.
Reload the contents of current view.
Copy current selection the clipboard.
Cut current selection to the clipboard.
Paste clipboard contents.
Delete current selection.
Select all text.
Input methods menu.
Unicode menu.
A proposed replacement for a misspelled word.
An indicator that spellchecking found no proposed replacements.
Causes the spellchecker to ignore the word for this session.
Causes the spellchecker to add the word to the dictionary.
Ignore grammar.
Font options menu.
Bold.
Italic.
Underline.
Outline.
Open current element in the inspector.
Open current video element in a new window.
Open current audio element in a new window.
Copy video link location in to the clipboard.
Copy audio link location in to the clipboard.
Enable or disable media controls.
Enable or disable media loop.
Show current video element in fullscreen mode.
Play current media element.
Pause current media element.
Mute current media element.
Download video to disk. Since 2.2
Download audio to disk. Since 2.2
Insert an emoji. Since 2.26
Paste clipboard contents as plain text. Since 2.30
Custom action defined by applications.
One item of a #WebKitContextMenu.
The #WebKitContextMenu is composed of #WebKitContextMenuItem<!--
-->s. These items can be created from a #GtkAction, from a
#WebKitContextMenuAction or from a #WebKitContextMenuAction and a
label. These #WebKitContextMenuAction<!-- -->s denote stock actions
for the items. You can also create separators and submenus.
Creates a new #WebKitContextMenuItem for the given @action and @label.
On activation
@target will be passed as parameter to the callback.
the newly created #WebKitContextMenuItem object.
a #GAction
the menu item label text
a #GVariant to use as the action target
Creates a new #WebKitContextMenuItem for the given stock action.
Stock actions are handled automatically by WebKit so that, for example,
when a menu item created with a %WEBKIT_CONTEXT_MENU_ACTION_STOP is
activated the action associated will be handled by WebKit and the current
load operation will be stopped. You can get the #GAction of a
#WebKitContextMenuItem created with a #WebKitContextMenuAction with
webkit_context_menu_item_get_gaction() and connect to the #GSimpleAction::activate signal
to be notified when the item is activated, but you can't prevent the associated
action from being performed.
the newly created #WebKitContextMenuItem object.
a #WebKitContextMenuAction stock action
Creates a new #WebKitContextMenuItem for the given stock action using the given @label.
Stock actions have a predefined label, this method can be used to create a
#WebKitContextMenuItem for a #WebKitContextMenuAction but using a custom label.
the newly created #WebKitContextMenuItem object.
a #WebKitContextMenuAction stock action
a custom label text to use instead of the predefined one
Creates a new #WebKitContextMenuItem representing a separator.
the newly created #WebKitContextMenuItem object.
Creates a new #WebKitContextMenuItem using the given @label with a submenu.
the newly created #WebKitContextMenuItem object.
the menu item label text
a #WebKitContextMenu to set
Gets the action associated to @item as a #GAction.
the #GAction associated to the #WebKitContextMenuItem,
or %NULL if @item is a separator.
a #WebKitContextMenuItem
Gets the #WebKitContextMenuAction of @item.
If the #WebKitContextMenuItem was not
created for a stock action %WEBKIT_CONTEXT_MENU_ACTION_CUSTOM will be
returned. If the #WebKitContextMenuItem is a separator %WEBKIT_CONTEXT_MENU_ACTION_NO_ACTION
will be returned.
the #WebKitContextMenuAction of @item
a #WebKitContextMenuItem
Gets the submenu of @item.
the #WebKitContextMenu representing the submenu of
@item or %NULL if @item doesn't have a submenu.
a #WebKitContextMenuItem
Checks whether @item is a separator.
%TRUE is @item is a separator or %FALSE otherwise
a #WebKitContextMenuItem
Sets or replaces the @item submenu.
If @submenu is %NULL the current
submenu of @item is removed.
a #WebKitContextMenuItem
a #WebKitContextMenu
A web page frame.
Each `WebKitWebPage` has at least one main frame, and can have any number
of subframes.
Gets the process-unique identifier of this #WebKitFrame. No other
frame in the same web process will have the same ID; however, frames
in other web processes may.
the identifier of @frame
a #WebKitFrame
Get the JavaScript execution context of @frame. Use this function to bridge
between the WebKit and JavaScriptCore APIs.
the #JSCContext for the JavaScript execution context of @frame.
a #WebKitFrame
Get the JavaScript execution context of @frame for the given #WebKitScriptWorld.
the #JSCContext for the JavaScript execution context of @frame for @world.
a #WebKitFrame
a #WebKitScriptWorld
Gets the current active URI of @frame.
the current active URI of @frame or %NULL if nothing has been
loaded yet.
a #WebKitFrame
Gets whether @frame is the main frame of a #WebKitWebPage
%TRUE if @frame is a main frame or %FALSE otherwise
a #WebKitFrame
Result of a Hit Test.
A Hit Test is an operation to get context information about a given
point in a #WebKitWebView. #WebKitHitTestResult represents the
result of a Hit Test. It provides context information about what is
at the coordinates of the Hit Test, such as if there's a link,
an image or a media.
You can get the context of the HitTestResult with
webkit_hit_test_result_get_context() that returns a bitmask of
#WebKitHitTestResultContext flags. You can also use
webkit_hit_test_result_context_is_link(), webkit_hit_test_result_context_is_image() and
webkit_hit_test_result_context_is_media() to determine whether there's
a link, image or a media element at the coordinates of the Hit Test.
Note that it's possible that several #WebKitHitTestResultContext flags
are active at the same time, for example if there's a link containing an image.
When the mouse is moved over a #WebKitWebView a Hit Test is performed
for the mouse coordinates and #WebKitWebView::mouse-target-changed
signal is emitted with a #WebKitHitTestResult.
Gets whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_EDITABLE flag is present in
#WebKitHitTestResult:context.
%TRUE if there's an editable element at the coordinates of the @hit_test_result,
or %FALSE otherwise
a #WebKitHitTestResult
Gets whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE flag is present in
#WebKitHitTestResult:context.
%TRUE if there's an image element in the coordinates of the Hit Test,
or %FALSE otherwise
a #WebKitHitTestResult
Gets whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK flag is present in
#WebKitHitTestResult:context.
%TRUE if there's a link element in the coordinates of the Hit Test,
or %FALSE otherwise
a #WebKitHitTestResult
Gets whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDIA flag is present in
#WebKitHitTestResult:context.
%TRUE if there's a media element in the coordinates of the Hit Test,
or %FALSE otherwise
a #WebKitHitTestResult
Gets whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_SCROLLBAR flag is present in
#WebKitHitTestResult:context.
%TRUE if there's a scrollbar element at the coordinates of the @hit_test_result,
or %FALSE otherwise
a #WebKitHitTestResult
Gets whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_SELECTION flag is present in
#WebKitHitTestResult:context.
%TRUE if there's a selected element at the coordinates of the @hit_test_result,
or %FALSE otherwise
a #WebKitHitTestResult
Gets the value of the #WebKitHitTestResult:context property.
a bitmask of #WebKitHitTestResultContext flags
a #WebKitHitTestResult
Gets the value of the #WebKitHitTestResult:image-uri property.
the URI of the image element in the coordinates of the Hit Test,
or %NULL if there isn't an image element in @hit_test_result context
a #WebKitHitTestResult
Gets the value of the #WebKitHitTestResult:link-label property.
the label of the link element in the coordinates of the Hit Test,
or %NULL if there isn't a link element in @hit_test_result context or the
link element doesn't have a label
a #WebKitHitTestResult
Gets the value of the #WebKitHitTestResult:link-title property.
the title of the link element in the coordinates of the Hit Test,
or %NULL if there isn't a link element in @hit_test_result context or the
link element doesn't have a title
a #WebKitHitTestResult
Gets the value of the #WebKitHitTestResult:link-uri property.
the URI of the link element in the coordinates of the Hit Test,
or %NULL if there isn't a link element in @hit_test_result context
a #WebKitHitTestResult
Gets the value of the #WebKitHitTestResult:media-uri property.
the URI of the media element in the coordinates of the Hit Test,
or %NULL if there isn't a media element in @hit_test_result context
a #WebKitHitTestResult
Bitmask of #WebKitHitTestResultContext flags representing
the context of the #WebKitHitTestResult.
The URI of the image if flag %WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE
is present in #WebKitHitTestResult:context
The label of the link if flag %WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK
is present in #WebKitHitTestResult:context
The title of the link if flag %WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK
is present in #WebKitHitTestResult:context
The URI of the link if flag %WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK
is present in #WebKitHitTestResult:context
The URI of the media if flag %WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDIA
is present in #WebKitHitTestResult:context
Enum values with flags representing the context of a #WebKitHitTestResult.
anywhere in the document.
a hyperlink element.
an image element.
a video or audio element.
an editable element
a scrollbar element.
a selected element. Since 2.8
Creates a new isolated #WebKitScriptWorld. Scripts executed in
isolated worlds have access to the DOM but not to other variable
or functions created by the page.
The #WebKitScriptWorld is created with a generated unique name. Use
webkit_script_world_new_with_name() if you want to create it with a
custom name.
You can get the JavaScript execution context of a #WebKitScriptWorld
for a given #WebKitFrame with webkit_frame_get_javascript_context_for_script_world().
a new isolated #WebKitScriptWorld
Creates a new isolated #WebKitScriptWorld with a name. Scripts executed in
isolated worlds have access to the DOM but not to other variable
or functions created by the page.
You can get the JavaScript execution context of a #WebKitScriptWorld
for a given #WebKitFrame with webkit_frame_get_javascript_context_for_script_world().
a new isolated #WebKitScriptWorld
a name for the script world
Get the default #WebKitScriptWorld. This is the normal script world
where all scripts are executed by default.
You can get the JavaScript execution context of a #WebKitScriptWorld
for a given #WebKitFrame with webkit_frame_get_javascript_context_for_script_world().
the default #WebKitScriptWorld
Get the name of a #WebKitScriptWorld.
the name of @world
a #WebKitScriptWorld
Emitted when the JavaScript window object in a #WebKitScriptWorld has been
cleared. This is the preferred place to set custom properties on the window
object using the JavaScriptCore API. You can get the window object of @frame
from the JavaScript execution context of @world that is returned by
webkit_frame_get_js_context_for_script_world().
a #WebKitWebPage
the #WebKitFrame to which @world belongs
Represents a URI request.
A #WebKitURIRequest can be created with a URI using the
webkit_uri_request_new() method, and you can get the URI of an
existing request with the webkit_uri_request_get_uri() one.
Creates a new #WebKitURIRequest for the given URI.
a new #WebKitURIRequest
an URI
Get the HTTP headers of a #WebKitURIRequest as a #SoupMessageHeaders.
a #SoupMessageHeaders with the HTTP headers of @request
or %NULL if @request is not an HTTP request.
a #WebKitURIRequest
Get the HTTP method of the #WebKitURIRequest.
the HTTP method of the #WebKitURIRequest or %NULL if @request is not
an HTTP request.
a #WebKitURIRequest
Obtains the request URI.
request URI, as a string.
a #WebKitURIRequest
Set the URI of @request
a #WebKitURIRequest
an URI
The URI to which the request will be made.
Represents an URI response.
A #WebKitURIResponse contains information such as the URI, the
status code, the content length, the mime type, the HTTP status or
the suggested filename.
Get the expected content length of the #WebKitURIResponse.
It can be 0 if the server provided an incorrect or missing Content-Length.
the expected content length of @response.
a #WebKitURIResponse
Get the HTTP headers of a #WebKitURIResponse as a #SoupMessageHeaders.
a #SoupMessageHeaders with the HTTP headers of @response
or %NULL if @response is not an HTTP response.
a #WebKitURIResponse
Gets the MIME type of the response.
MIME type, as a string.
a #WebKitURIResponse
Get the status code of the #WebKitURIResponse.
Get the status code of the #WebKitURIResponse as returned by
the server. It will normally be a #SoupKnownStatusCode, for
example %SOUP_STATUS_OK, though the server can respond with any
unsigned integer.
the status code of @response
a #WebKitURIResponse
Get the suggested filename for @response.
Get the suggested filename for @response, as specified by
the 'Content-Disposition' HTTP header, or %NULL if it's not
present.
the suggested filename or %NULL if
the 'Content-Disposition' HTTP header is not present.
a #WebKitURIResponse
Gets the URI which resulted in the response.
response URI, as a string.
a #WebKitURIResponse
The expected content length of the response.
The HTTP headers of the response, or %NULL if the response is not an HTTP response.
The MIME type of the response.
The status code of the response as returned by the server.
The suggested filename for the URI response.
The URI for which the response was made.
Message that can be sent between the UI process and web process extensions.
A WebKitUserMessage is a message that can be used for the communication between the UI process
and web process extensions. A WebKitUserMessage always has a name, and it can also include parameters and
UNIX file descriptors. Messages can be sent from a #WebKitWebContext to all web process extensions,
from a web process extension to its corresponding #WebKitWebContext, and from a #WebKitWebView to its
corresponding #WebKitWebPage (and vice versa). One to one messages can be replied to directly with
webkit_user_message_send_reply().
Create a new #WebKitUserMessage with @name.
the newly created #WebKitUserMessage object.
the message name
the message parameters as a #GVariant, or %NULL
Create a new #WebKitUserMessage including also a list of UNIX file descriptors to be sent.
the newly created #WebKitUserMessage object.
the message name
the message parameters as a #GVariant
the message file descriptors
Gets the quark for the domain of user message errors.
user message error domain.
Get the @message list of file descritpor.
the message list of file descriptors
a #WebKitUserMessage
Get the @message name.
the message name
a #WebKitUserMessage
Get the @message parameters.
the message parameters
a #WebKitUserMessage
Send a reply to an user message.
If @reply is floating, it's consumed.
You can only send a reply to a #WebKitUserMessage that has been
received.
a #WebKitUserMessage
a #WebKitUserMessage to send as reply
The UNIX file descriptors of the user message.
The name of the user message.
The parameters of the user message as a #GVariant, or %NULL
if the message doesn't include parameters. Note that only complete types are
allowed.
Enum values used to denote errors happening when sending user messages.
The message was not handled by the receiver.
Access to editing capabilities of a #WebKitWebPage.
The WebKitWebEditor provides access to various editing capabilities of
a #WebKitWebPage such as a possibility to react to the current selection in
#WebKitWebPage.
Gets the #WebKitWebPage that is associated with the #WebKitWebEditor.
the associated #WebKitWebPage
a #WebKitWebEditor
This signal is emitted for every selection change inside a #WebKitWebPage
as well as for every caret position change as the caret is a collapsed
selection.
Form manager of a #WebKitWebPage in a #WebKitScriptWorld
Set the value of an HTML input element as if it had been edited by
the user, triggering a change event, and set it as filled automatically.
If @element is not an HTML input element this function does nothing.
a #JSCValue
the text to set
Get whether @element is an HTML input element that has been filled automatically.
%TRUE if @element is an HTML input element that has been filled automatically,
or %FALSE otherwise
a #JSCValue
Get whether @element is an HTML text input element that has been edited by a user action.
%TRUE if @element is an HTML text input element that has been edited by a user action,
or %FALSE otherwise
a #JSCValue
Emitted after form elements (or form associated elements) are associated to @frame.
This is useful to implement form auto filling for web pages where form fields are added
dynamically. This signal might be emitted multiple times for the same frame.
Note that this signal could be also emitted when form controls are moved between forms. In
that case, the @elements array carries the list of those elements which have moved.
Clients should take a reference to the members of the @elements array if it is desired to
keep them alive after the signal handler returns.
a #WebKitFrame
a #GPtrArray of
#JSCValue with the list of forms in the page
This signal is emitted when the DOM submit event is about to be fired for @form.
JavaScript code may rely on the submit event to detect that the user has clicked
on a submit button, and to possibly cancel the form submission before
#WebKitWebFormManager::will-submit-form signal is emitted.
However, beware that, for historical reasons, the submit event is not emitted at
all if the form submission is triggered by JavaScript. For these reasons,
this signal may not be used to reliably detect whether a form will be submitted.
Instead, use it to detect if a user has clicked on a form's submit button even if
JavaScript later cancels the form submission, or to read the values of the form's
fields even if JavaScript later clears certain fields before submitting. This may
be needed, for example, to implement a robust browser password manager, as some
misguided websites may use such techniques to attempt to thwart password managers.
the #JSCValue to be submitted, which will always correspond to an HTMLFormElement
the #WebKitFrame containing the form to be submitted
the #WebKitFrame containing the form's target,
which may be the same as @source_frame if no target was specified
This signal is emitted when @form will imminently be submitted. It can no longer
be cancelled. This event always occurs immediately before a form is submitted to
its target, so use this event to reliably detect when a form is submitted. This
signal is emitted after #WebKitWebFormManager::will-send-submit-event if that
signal is emitted.
the #JSCValue to be submitted, which will always correspond to an HTMLFormElement
the #WebKitFrame containing the form to be submitted
the #WebKitFrame containing the form's target,
which may be the same as @source_frame if no target was specified
Result of a Hit Test (Web Process Extensions).
WebKitWebHitTestResult extends #WebKitHitTestResult to provide information
about the #WebKitDOMNode in the coordinates of the Hit Test.
Check whether there is an editable element at the hit test position.
Checks whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_EDITABLE flag is present in
the context flags.
%TRUE if the hit test covers an editable element or %FALSE otherwise.
a #WebWebKitHitTestResult
Check whether there is an image element at the hit test position.
Checks whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_IMAGE flag is present in
the context flags.
%TRUE if the hit test covers an image element or %FALSE otherwise.
a #WebWebKitHitTestResult
Check whether there is a link element at the hit test position.
Checks whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_LINK flag is present in
the context flags.
%TRUE if the hit test covers a link element or %FALSE otherwise.
a #WebWebKitHitTestResult
Check whether there is a media element at the hit test position.
Checks whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_MEDIA flag is present in
the context flags.
%TRUE if the hit test covers a media element or %FALSE otherwise.
a #WebWebKitHitTestResult
Check whether there is a scrollbar at the hit test position.
Checks whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_SCROLLBAR flag is present in
the context flags.
%TRUE if the hit test covers a scrollbar or %FALSE otherwise.
a #WebWebKitHitTestResult
Check whether there is a selected element at the hit test position.
Checks whether %WEBKIT_HIT_TEST_RESULT_CONTEXT_SELECTION flag is present in
the context flags.
%TRUE if the hit test covers a selected element or %FALSE otherwise.
a #WebWebKitHitTestResult
Gets the the context flags for the hit test result.
a bitmask of #WebKitHitTestResultContext flags
a #WebKitWebHitTestResult
Obtains the URI associated with the image element at the hit test position.
the URI of the image element, or %NULL if the hit test does not cover an image element.
a #WebWebKitHitTestResult
Get the #JSCValue for the DOM node in @world at the coordinates of the Hit Test.
a #JSCValue for the DOM node, or %NULL
a #WebKitWebHitTestResult
a #WebKitScriptWorld, or %NULL to use the default
Obtains the label associated with the link element at the hit test position.
the label of the link element, or %NULL if the hit test does not cover a link element
or the link element does not have a label.
a #WebWebKitHitTestResult
Obtains the title associated with the link element at the hit test position.
the title of the link element, or %NULL if the hit test does not cover a link element
or the link element does not have a title.
a #WebWebKitHitTestResult
Obtains the URI associated with the link element at the hit test position.
the URI of the link element, or %NULL if the hit test does not cover a link element.
a #WebWebKitHitTestResult
Obtains the URI associated with the media element at the hit test position.
the URI of the media element, or %NULL if the hit test does not cover a media element.
a #WebWebKitHitTestResult
A loaded web page.
Gets the #WebKitWebEditor of a #WebKitWebPage.
the #WebKitWebEditor
a #WebKitWebPage
Get the #WebKitWebFormManager of @web_page in @world.
a #WebKitWebFormManager
a #WebKitWebPage
a #WebKitScriptWorld
Get the identifier of the #WebKitWebPage
the identifier of @web_page
a #WebKitWebPage
Returns the main frame of a #WebKitWebPage.
the #WebKitFrame that is the main frame of @web_page
a #WebKitWebPage
Returns the current active URI of @web_page.
You can monitor the active URI by connecting to the notify::uri
signal of @web_page.
the current active URI of @web_view or %NULL if nothing has been
loaded yet.
a #WebKitWebPage
Send @message to the #WebKitWebView corresponding to @web_page. If @message is floating, it's consumed.
If you don't expect any reply, or you simply want to ignore it, you can pass %NULL as @callback.
When the operation is finished, @callback will be called. You can then call
webkit_web_page_send_message_to_view_finish() to get the message reply.
a #WebKitWebPage
a #WebKitUserMessage
a #GCancellable or %NULL to ignore
A #GAsyncReadyCallback to call when the request is satisfied or %NULL
the data to pass to callback function
Finish an asynchronous operation started with webkit_web_page_send_message_to_view().
a #WebKitUserMessage with the reply or %NULL in case of error.
a #WebKitWebPage
a #GAsyncResult
The current active URI of the #WebKitWebPage.
Emitted when a message is sent to the console. This can be a message
produced by the use of JavaScript console API, a JavaScript exception,
a security error or other errors, warnings, debug or log messages.
The @console_message contains information of the message.
the #WebKitConsoleMessage
Emitted before a context menu is displayed in the UI Process to
give the application a chance to customize the proposed menu,
build its own context menu or pass user data to the UI Process.
This signal is useful when the information available in the UI Process
is not enough to build or customize the context menu, for example, to
add menu entries depending on the node at the coordinates of the
@hit_test_result. Otherwise, it's recommended to use #WebKitWebView::context-menu
signal instead.
%TRUE if the proposed @context_menu has been modified, or %FALSE otherwise.
the proposed #WebKitContextMenu
a #WebKitWebHitTestResult
This signal is emitted when the DOM document of a #WebKitWebPage has been
loaded.
You can wait for this signal to get the DOM document
This signal is emitted when @request is about to be sent to
the server. This signal can be used to modify the #WebKitURIRequest
that will be sent to the server. You can also cancel the resource load
operation by connecting to this signal and returning %TRUE.
In case of a server redirection this signal is
emitted again with the @request argument containing the new
request to be sent to the server due to the redirection and the
@redirected_response parameter containing the response
received by the server for the initial request.
Modifications to the #WebKitURIRequest and its associated
#SoupMessageHeaders will be taken into account when the request
is sent over the network.
%TRUE to stop other handlers from being invoked for the event.
%FALSE to continue emission of the event.
a #WebKitURIRequest
a #WebKitURIResponse, or %NULL
This signal is emitted when a #WebKitUserMessage is received from the
#WebKitWebView corresponding to @web_page. You can reply to the message
using webkit_user_message_send_reply().
You can handle the user message asynchronously by calling g_object_ref() on
@message and returning %TRUE. If the last reference of @message is removed
and the message has been replied, the operation in the #WebKitWebView will
finish with error %WEBKIT_USER_MESSAGE_UNHANDLED_MESSAGE.
%TRUE if the message was handled, or %FALSE otherwise.
the #WebKitUserMessage received
Represents an extension of the web process.
WebKitWebProcessExtension is a loadable module for the web process. It allows you to execute code in the
web process and being able to use the DOM API, to change any request or to inject custom
JavaScript code, for example.
To create a WebKitWebProcessExtension you should write a module with an initialization function that could
be either webkit_web_process_extension_initialize() with prototype #WebKitWebProcessExtensionInitializeFunction or
webkit_web_process_extension_initialize_with_user_data() with prototype #WebKitWebProcessExtensionInitializeWithUserDataFunction.
This function has to be public and it has to use the #G_MODULE_EXPORT macro. It is called when the
web process is initialized.
```c
static void
web_page_created_callback (WebKitWebProcessExtension *extension,
WebKitWebPage *web_page,
gpointer user_data)
{
g_print ("Page %d created for %s\n",
webkit_web_page_get_id (web_page),
webkit_web_page_get_uri (web_page));
}
G_MODULE_EXPORT void
webkit_web_process_extension_initialize (WebKitWebProcessExtension *extension)
{
g_signal_connect (extension, "page-created",
G_CALLBACK (web_page_created_callback),
NULL);
}
```
The previous piece of code shows a trivial example of an extension that notifies when
a #WebKitWebPage is created.
WebKit has to know where it can find the created WebKitWebProcessExtension. To do so you
should use the webkit_web_context_set_web_extensions_directory() function. The signal
#WebKitWebContext::initialize-web-extensions is the recommended place to call it.
To provide the initialization data used by the webkit_web_process_extension_initialize_with_user_data()
function, you have to call webkit_web_context_set_web_extensions_initialization_user_data() with
the desired data as parameter. You can see an example of this in the following piece of code:
```c
#define WEB_EXTENSIONS_DIRECTORY // ...
static void
initialize_web_extensions (WebKitWebContext *context,
gpointer user_data)
{
// Web Extensions get a different ID for each Web Process
static guint32 unique_id = 0;
webkit_web_context_set_web_extensions_directory (
context, WEB_EXTENSIONS_DIRECTORY);
webkit_web_context_set_web_extensions_initialization_user_data (
context, g_variant_new_uint32 (unique_id++));
}
int main (int argc, char **argv)
{
g_signal_connect (webkit_web_context_get_default (),
"initialize-web-extensions",
G_CALLBACK (initialize_web_extensions),
NULL);
GtkWidget *view = webkit_web_view_new ();
// ...
}
```
Get the web page of the given @page_id.
the #WebKitWebPage for the given @page_id, or %NULL if the
identifier doesn't correspond to an existing web page.
a #WebKitWebProcessExtension
the identifier of the #WebKitWebPage to get
Send @message to the #WebKitWebContext corresponding to @extension. If @message is floating, it's consumed.
If you don't expect any reply, or you simply want to ignore it, you can pass %NULL as @calback.
When the operation is finished, @callback will be called. You can then call
webkit_web_process_extension_send_message_to_context_finish() to get the message reply.
a #WebKitWebProcessExtension
a #WebKitUserMessage
a #GCancellable or %NULL to ignore
A #GAsyncReadyCallback to call when the request is satisfied or %NULL
the data to pass to callback function
Finish an asynchronous operation started with webkit_web_process_extension_send_message_to_context().
a #WebKitUserMessage with the reply or %NULL in case of error.
a #WebKitWebProcessExtension
a #GAsyncResult
This signal is emitted when a new #WebKitWebPage is created in
the Web Process.
the #WebKitWebPage created
This signal is emitted when a #WebKitUserMessage is received from the
#WebKitWebContext corresponding to @extension. Messages sent by #WebKitWebContext
are always broadcasted to all web extensions and they can't be
replied to. Calling webkit_user_message_send_reply() will do nothing.
the #WebKitUserMessage received
Type definition for a function that will be called to initialize
the web extension when the web process starts.
a #WebKitWebProcessExtension
Type definition for a function that will be called to initialize
the web extensions when the web process starts, and which receives
as additional argument the user data set with
webkit_web_context_set_web_process_extensions_initialization_user_data().
a #WebKitWebProcessExtension
a #GVariant