:right-sidebar: True

AutomationSession
===================================================================

.. currentmodule:: gi.repository.WebKit


.. versionadded:: 2.18




.. class:: AutomationSession(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.GObject.Object`





Automation Session.

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
:obj:`~gi.repository.WebKit.WebView` to interact with it. When this happens the signal :obj:`~gi.repository.WebKit.AutomationSession`\::create-web-view
is emitted.




Methods
-------

.. rst-class:: interim-class

.. class:: AutomationSession
   :no-index:


   .. method:: get_application_info() -> ~gi.repository.WebKit.ApplicationInfo

      Get the the previously set :obj:`~gi.repository.WebKit.AutomationSession`\.

      Get the :obj:`~gi.repository.WebKit.AutomationSession` previously set with :func:`~gi.repository.WebKit.AutomationSession.set_application_info`.


      .. versionadded:: 2.18








   .. method:: get_id() -> str

      Get the unique identifier of a :obj:`~gi.repository.WebKit.AutomationSession`


      .. versionadded:: 2.18








   .. method:: set_application_info(info: ~gi.repository.WebKit.ApplicationInfo) -> None

      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
      :obj:`~gi.repository.WebKit.WebContext`\::automation-started signal.


      .. versionadded:: 2.18





      :param info: a :obj:`~gi.repository.WebKit.ApplicationInfo`








Properties
----------

.. rst-class:: interim-class

.. class:: AutomationSession
   :no-index:
   

   .. attribute:: props.id
      :type: str

      The type of the None singleton.



      .. versionadded:: 2.18









Signals
-------

.. rst-class:: interim-class

.. class:: AutomationSession.signals
   :no-index:
   

   .. method:: create_web_view() -> ~gi.repository.WebKit.WebView

      The type of the None singleton.



      .. versionadded:: 2.18








   .. method:: will_close() -> None

      The type of the None singleton.



      .. versionadded:: 2.46