:right-sidebar: True

CookieJarDB
===================================================================

.. currentmodule:: gi.repository.Soup





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


Superclasses: :class:`~gi.repository.Soup.CookieJar`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Soup.SessionFeature`



Database-based Cookie Jar.

``SoupCookieJarDB`` is a :obj:`~gi.repository.Soup.CookieJar` that reads cookies from and writes
them to a sqlite database in the new Mozilla format.

(This is identical to ``SoupCookieJarSqlite`` in
libsoup-gnome; it has just been moved into libsoup proper, and
renamed to avoid conflicting.)


Constructors
------------

.. rst-class:: interim-class

.. class:: CookieJarDB
   :no-index:


   .. classmethod:: new(filename: str, read_only: bool) -> ~gi.repository.Soup.CookieJar

      Creates a ``SoupCookieJarDB``.

      ``filename`` will be read in at startup to create an initial set of cookies. If
      ``read_only`` is :const:`False`, then the non-session cookies will be written to
      ``filename`` when the :obj:`~gi.repository.Soup.CookieJar.signals.changed` signal is emitted from the
      jar. (If ``read_only`` is :const:`True`, then the cookie jar will only be used for this
      session, and changes made to it will be lost when the jar is destroyed.)






      :param filename: the filename to read to/write from, or :const:`None`

      :param read_only: :const:`True` if ``filename`` is read-only










Properties
----------

.. rst-class:: interim-class

.. class:: CookieJarDB
   :no-index:
   

   .. attribute:: props.filename
      :type: str

      The type of the None singleton.