gi-webkit2-4.0.24: WebKit2 bindings

CopyrightWill Thompson Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (inaki@blueleaf.cc)
Safe HaskellNone
LanguageHaskell2010

GI.WebKit2.Objects.CookieManager

Contents

Description

No description available in the introspection data.

Synopsis

Exported types

newtype CookieManager Source #

Memory-managed wrapper type.

class (GObject o, IsDescendantOf CookieManager o) => IsCookieManager o Source #

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

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

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

Methods

addCookie

cookieManagerAddCookie Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 Source #

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 () Source #

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

type CookieManagerChangedCallback = IO () Source #

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

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

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

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

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