GI.WebKit2.Objects.CookieManager

No description available in the introspection data.

Exported types

newtype CookieManager

Memory-managed wrapper type.

Constructors

CookieManager (ManagedPtr CookieManager)

Instances

GObject CookieManager

Methods

gobjectType :: CookieManager -> IO GType

IsObject CookieManager

IsCookieManager CookieManager

class GObject o => IsCookieManager o

Type class for types which can be safely cast to CookieManager, for instance with toCookieManager.

Instances

(GObject a, (UnknownAncestorError CookieManager a :: Constraint)) => IsCookieManager a

IsCookieManager CookieManager

toCookieManager :: (MonadIO m, IsCookieManager o) => o -> m CookieManager

Cast to CookieManager, for types for which this is known to be safe. For general casts, use castTo.

noCookieManager :: Maybe CookieManager

A convenience alias for Nothing :: Maybe CookieManager.

Methods

addCookie

cookieManagerAddCookie

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsCancellable b)

=> a

cookieManager: a CookieManager

-> Cookie

cookie: the Cookie to be added

-> Maybe b

cancellable: a Cancellable or Nothing to ignore

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Asynchronously add a Cookie to the underlying storage.

When the operation is finished, callback will be called. You can then call cookieManagerAddCookieFinish to get the result of the operation.

Since: 2.20

addCookieFinish

cookieManagerAddCookieFinish

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsAsyncResult b)

=> a

cookieManager: a CookieManager

-> b

result: a AsyncResult

-> m ()

(Can throw GError)

Finish an asynchronous operation started with cookieManagerAddCookie.

Since: 2.20

deleteAllCookies

cookieManagerDeleteAllCookies

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a)

=> a

cookieManager: a CookieManager

-> m ()

Deprecated: (Since version 2.16)Use websiteDataManagerClear instead.

Delete all cookies of cookieManager

deleteCookie

cookieManagerDeleteCookie

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsCancellable b)

=> a

cookieManager: a CookieManager

-> Cookie

cookie: the Cookie to be deleted

-> Maybe b

cancellable: a Cancellable or Nothing to ignore

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Asynchronously delete a Cookie from the current session.

When the operation is finished, callback will be called. You can then call cookieManagerDeleteCookieFinish to get the result of the operation.

Since: 2.20

deleteCookieFinish

cookieManagerDeleteCookieFinish

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsAsyncResult b)

=> a

cookieManager: a CookieManager

-> b

result: a AsyncResult

-> m ()

(Can throw GError)

Finish an asynchronous operation started with cookieManagerDeleteCookie.

Since: 2.20

deleteCookiesForDomain

cookieManagerDeleteCookiesForDomain

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a)

=> a

cookieManager: a CookieManager

-> Text

domain: a domain name

-> m ()

Deprecated: (Since version 2.16)Use websiteDataManagerRemove instead.

Remove all cookies of cookieManager for the given domain.

getAcceptPolicy

cookieManagerGetAcceptPolicy

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsCancellable b)

=> a

cookieManager: a CookieManager

-> Maybe b

cancellable: a Cancellable or Nothing to ignore

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Asynchronously get the cookie acceptance policy of cookieManager.

When the operation is finished, callback will be called. You can then call cookieManagerGetAcceptPolicyFinish to get the result of the operation.

getAcceptPolicyFinish

cookieManagerGetAcceptPolicyFinish

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsAsyncResult b)

=> a

cookieManager: a CookieManager

-> b

result: a AsyncResult

-> m CookieAcceptPolicy

Returns: the cookie acceptance policy of cookieManager as a CookieAcceptPolicy. (Can throw GError)

Finish an asynchronous operation started with cookieManagerGetAcceptPolicy.

getCookies

cookieManagerGetCookies

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsCancellable b)

=> a

cookieManager: a CookieManager

-> Text

uri: the URI associated to the cookies to be retrieved

-> Maybe b

cancellable: a Cancellable or Nothing to ignore

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Asynchronously get a list of Cookie from cookieManager associated with uri, which must be either an HTTP or an HTTPS URL.

When the operation is finished, callback will be called. You can then call cookieManagerGetCookiesFinish to get the result of the operation.

Since: 2.20

getCookiesFinish

cookieManagerGetCookiesFinish

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsAsyncResult b)

=> a

cookieManager: a CookieManager

-> b

result: a AsyncResult

-> m [Cookie]

Returns: A List of Cookie instances. (Can throw GError)

Finish an asynchronous operation started with cookieManagerGetCookies. The return value is a SList of Cookie instances which should be released with g_list_free_full() and cookieFree.

Since: 2.20

getDomainsWithCookies

cookieManagerGetDomainsWithCookies

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsCancellable b)

=> a

cookieManager: a CookieManager

-> Maybe b

cancellable: a Cancellable or Nothing to ignore

-> Maybe AsyncReadyCallback

callback: a AsyncReadyCallback to call when the request is satisfied

-> m ()

Deprecated: (Since version 2.16)Use websiteDataManagerFetch instead.

Asynchronously get the list of domains for which cookieManager contains cookies.

When the operation is finished, callback will be called. You can then call cookieManagerGetDomainsWithCookiesFinish to get the result of the operation.

getDomainsWithCookiesFinish

cookieManagerGetDomainsWithCookiesFinish

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a, IsAsyncResult b)

=> a

cookieManager: a CookieManager

-> b

result: a AsyncResult

-> m [Text]

Returns: A Nothing terminated array of domain names or Nothing in case of error. (Can throw GError)

Deprecated: (Since version 2.16)Use websiteDataManagerFetchFinish instead.

Finish an asynchronous operation started with cookieManagerGetDomainsWithCookies. The return value is a Nothing terminated list of strings which should be released with strfreev.

setAcceptPolicy

cookieManagerSetAcceptPolicy

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a)

=> a

cookieManager: a CookieManager

-> CookieAcceptPolicy

policy: a CookieAcceptPolicy

-> m ()

Set the cookie acceptance policy of cookieManager as policy.

setPersistentStorage

cookieManagerSetPersistentStorage

Arguments

:: (HasCallStack, MonadIO m, IsCookieManager a)

=> a

cookieManager: a CookieManager

-> Text

filename: the filename to read to/write from

-> CookiePersistentStorage

storage: a CookiePersistentStorage

-> m ()

Set the filename where non-session cookies are stored persistently using storage as the format to read/write the cookies. Cookies are initially read from filename to create an initial set of cookies. Then, non-session cookies will be written to filename when the WebKitCookieManager::changed signal is emitted. By default, cookieManager doesn't store the cookies persistently, so you need to call this method to keep cookies saved across sessions.

This method should never be called on a CookieManager associated to an ephemeral WebsiteDataManager.

Signals

changed

type C_CookieManagerChangedCallback = Ptr () -> Ptr () -> IO ()

Type for the callback on the (unwrapped) C side.

type CookieManagerChangedCallback = IO ()

This signal is emitted when cookies are added, removed or modified.

afterCookieManagerChanged :: (IsCookieManager a, MonadIO m) => a -> CookieManagerChangedCallback -> m SignalHandlerId

Connect a signal handler for the “changed” signal, to be run after the default handler. When overloading is enabled, this is equivalent to

after cookieManager #changed callback

genClosure_CookieManagerChanged :: CookieManagerChangedCallback -> IO Closure

Wrap the callback into a Closure.

mk_CookieManagerChangedCallback :: C_CookieManagerChangedCallback -> IO (FunPtr C_CookieManagerChangedCallback)

Generate a function pointer callable from C code, from a C_CookieManagerChangedCallback.

noCookieManagerChangedCallback :: Maybe CookieManagerChangedCallback

A convenience synonym for Nothing :: Maybe CookieManagerChangedCallback.

onCookieManagerChanged :: (IsCookieManager a, MonadIO m) => a -> CookieManagerChangedCallback -> m SignalHandlerId

Connect a signal handler for the “changed” signal, to be run before the default handler. When overloading is enabled, this is equivalent to

on cookieManager #changed callback

wrap_CookieManagerChangedCallback :: CookieManagerChangedCallback -> C_CookieManagerChangedCallback

Wrap a CookieManagerChangedCallback into a C_CookieManagerChangedCallback.