WebKitAutomationSession: WebKitGTK Reference Manual

WebKitAutomationSession

WebKitAutomationSession — Automation Session

Functions

const char *	webkit_automation_session_get_id ()
void	webkit_automation_session_set_application_info ()
WebKitApplicationInfo *	webkit_automation_session_get_application_info ()

Properties

gchar *

Read / Write / Construct Only

Signals

WebKitWebView*

create-web-view

Run Last

Types and Values

struct

WebKitAutomationSession

Object Hierarchy

    GObject
    ╰── WebKitAutomationSession

Description

WebKitAutomationSession represents an automation session of a WebKitWebContext. When a new session is requested, a WebKitAutomationSession is created and the signal WebKitWebContext::automation-started is emitted with the WebKitAutomationSession as argument. Then, the automation client can request the session to create a new WebKitWebView to interact with it. When this happens the signal “create-web-view” is emitted.

Functions

webkit_automation_session_get_id ()

const char *
webkit_automation_session_get_id (WebKitAutomationSession *session);

Get the unique identifier of a WebKitAutomationSession

Parameters

session

a WebKitAutomationSession

Returns

the unique identifier of session

Since: 2.18

webkit_automation_session_set_application_info ()

void
webkit_automation_session_set_application_info
                               (WebKitAutomationSession *session,
                                WebKitApplicationInfo *info);

Set the application information to session . This information will be used by the driver service to match the requested capabilities with the actual application information. If this information is not provided to the session when a new automation session is requested, the creation might fail if the client requested a specific browser name or version. This will not have any effect when called after the automation session has been fully created, so this must be called in the callback of “automation-started” signal.

Parameters

session	a WebKitAutomationSession
info	a WebKitApplicationInfo

Since: 2.18

webkit_automation_session_get_application_info ()

WebKitApplicationInfo *
webkit_automation_session_get_application_info
                               (WebKitAutomationSession *session);

Get the WebKitAutomationSession previously set with webkit_automation_session_set_application_info().

Parameters

session

a WebKitAutomationSession

Returns

the WebKitAutomationSession of session , or NULL if no one has been set.

[transfer none]

Since: 2.18

Types and Values

struct WebKitAutomationSession

struct WebKitAutomationSession;

Property Details

The `“id”` property

  “id”                       gchar *

The session unique identifier.

Owner: WebKitAutomationSession

Flags: Read / Write / Construct Only

Default value: NULL

Since: 2.18

Signal Details

The `“create-web-view”` signal

WebKitWebView*
user_function (WebKitAutomationSession *session,
               gpointer                 user_data)

This signal is emitted when the automation client requests a new browsing context to interact with it. The callback handler should return a WebKitWebView created with “is-controlled-by-automation” construct property enabled. The returned WebKitWebView could be an existing web view or a new one created and added to a new tab or window.

Parameters

session	a WebKitAutomationSession
user_data	user data set when the signal handler was connected.

Returns

a WebKitWebView widget.

[transfer none]

Flags: Run Last

Since: 2.18