Copyright | Will Thompson and Iñaki García Etxebarria |
---|---|
License | LGPL-2.1 |
Maintainer | Iñaki García Etxebarria |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Automation Session.
WebKitAutomationSession represents an automation session of a WebKitWebContext.
When a new session is requested, a WebKitAutomationSession is created and the signal
WebKitWebContextautomationStarted is emitted with the WebKitAutomationSession as
argument. Then, the automation client can request the session to create a new
WebView
to interact with it. When this happens the signal AutomationSession::createWebView
is emitted.
Since: 2.18
Synopsis
- newtype AutomationSession = AutomationSession (ManagedPtr AutomationSession)
- class (GObject o, IsDescendantOf AutomationSession o) => IsAutomationSession o
- toAutomationSession :: (MonadIO m, IsAutomationSession o) => o -> m AutomationSession
- automationSessionGetApplicationInfo :: (HasCallStack, MonadIO m, IsAutomationSession a) => a -> m ApplicationInfo
- automationSessionGetId :: (HasCallStack, MonadIO m, IsAutomationSession a) => a -> m Text
- automationSessionSetApplicationInfo :: (HasCallStack, MonadIO m, IsAutomationSession a) => a -> ApplicationInfo -> m ()
- constructAutomationSessionId :: (IsAutomationSession o, MonadIO m) => Text -> m (GValueConstruct o)
- getAutomationSessionId :: (MonadIO m, IsAutomationSession o) => o -> m Text
- type AutomationSessionCreateWebViewCallback = IO WebView
- afterAutomationSessionCreateWebView :: (IsAutomationSession a, MonadIO m) => a -> Maybe Text -> ((?self :: a) => AutomationSessionCreateWebViewCallback) -> m SignalHandlerId
- onAutomationSessionCreateWebView :: (IsAutomationSession a, MonadIO m) => a -> Maybe Text -> ((?self :: a) => AutomationSessionCreateWebViewCallback) -> m SignalHandlerId
Exported types
newtype AutomationSession Source #
Memory-managed wrapper type.
AutomationSession (ManagedPtr AutomationSession) |
Instances
class (GObject o, IsDescendantOf AutomationSession o) => IsAutomationSession o Source #
Type class for types which can be safely cast to AutomationSession
, for instance with toAutomationSession
.
Instances
(GObject o, IsDescendantOf AutomationSession o) => IsAutomationSession o Source # | |
Defined in GI.WebKit.Objects.AutomationSession |
toAutomationSession :: (MonadIO m, IsAutomationSession o) => o -> m AutomationSession Source #
Cast to AutomationSession
, for types for which this is known to be safe. For general casts, use castTo
.
Methods
Click to display all available methods, including inherited ones
Methods
bindProperty, bindPropertyFull, forceFloating, freezeNotify, getv, isFloating, notify, notifyByPspec, ref, refSink, runDispose, stealData, stealQdata, thawNotify, unref, watchClosure.
Getters
getApplicationInfo, getData, getId, getProperty, getQdata.
Setters
getApplicationInfo
automationSessionGetApplicationInfo Source #
:: (HasCallStack, MonadIO m, IsAutomationSession a) | |
=> a |
|
-> m ApplicationInfo | Returns: the |
Get the the previously set AutomationSession
.
Get the AutomationSession
previously set with automationSessionSetApplicationInfo
.
Since: 2.18
getId
automationSessionGetId Source #
:: (HasCallStack, MonadIO m, IsAutomationSession a) | |
=> a |
|
-> m Text | Returns: the unique identifier of |
Get the unique identifier of a AutomationSession
Since: 2.18
setApplicationInfo
automationSessionSetApplicationInfo Source #
:: (HasCallStack, MonadIO m, IsAutomationSession a) | |
=> a |
|
-> ApplicationInfo |
|
-> m () |
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 WebContext::automationStarted signal.
Since: 2.18
Properties
id
The session unique identifier.
Since: 2.18
constructAutomationSessionId :: (IsAutomationSession o, MonadIO m) => Text -> m (GValueConstruct o) Source #
Construct a GValueConstruct
with valid value for the “id
” property. This is rarely needed directly, but it is used by new
.
getAutomationSessionId :: (MonadIO m, IsAutomationSession o) => o -> m Text Source #
Get the value of the “id
” property.
When overloading is enabled, this is equivalent to
get
automationSession #id
Signals
createWebView
type AutomationSessionCreateWebViewCallback Source #
This signal is emitted when the automation client requests a new
browsing context to interact with it. The callback handler should
return a WebView
created with WebView:isControlledByAutomation
construct property enabled and WebView:automationPresentationType construct
property set if needed.
If the signal is emitted with "tab" detail, the returned WebView
should be
a new web view added to a new tab of the current browsing context window.
If the signal is emitted with "window" detail, the returned WebView
should be
a new web view added to a new window.
When creating a new web view and there's an active browsing context, the new window
or tab shouldn't be focused.
Since: 2.18
afterAutomationSessionCreateWebView :: (IsAutomationSession a, MonadIO m) => a -> Maybe Text -> ((?self :: a) => AutomationSessionCreateWebViewCallback) -> m SignalHandlerId Source #
Connect a signal handler for the createWebView signal, to be run after the default handler. When overloading is enabled, this is equivalent to
after
automationSession #createWebView callback
This signal admits a optional parameter detail
.
If it's not Nothing
, we will connect to “create-web-view::detail
” instead.
By default the object invoking the signal is not passed to the callback.
If you need to access it, you can use the implit ?self
parameter.
Note that this requires activating the ImplicitParams
GHC extension.
onAutomationSessionCreateWebView :: (IsAutomationSession a, MonadIO m) => a -> Maybe Text -> ((?self :: a) => AutomationSessionCreateWebViewCallback) -> m SignalHandlerId Source #
Connect a signal handler for the createWebView signal, to be run before the default handler. When overloading is enabled, this is equivalent to
on
automationSession #createWebView callback
This signal admits a optional parameter detail
.
If it's not Nothing
, we will connect to “create-web-view::detail
” instead.