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 * | id | 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.

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